Array.prototype.join()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
El métodojoin() une todos los elementos de una matriz (o unobjeto similar a una matriz) en una cadena y devuelve esta cadena.
Pruébalo
const elements = ["Fire", "Air", "Water"];console.log(elements.join());// Expected output: "Fire,Air,Water"console.log(elements.join(""));// Expected output: "FireAirWater"console.log(elements.join("-"));// Expected output: "Fire-Air-Water"Sintaxis
arr.join([separator])
Parámetros
separadorOpcionalEs una
cadenausada para separar cada uno de los elementos del arreglo. El separador es convertido a unacadenasi es necesario. Si este se omite, los elementos del arreglo son separados con una coma (","). Si elseparadores unacadenavacía todos los elementos son unidos sin ningún carácter entre ellos.
Valor de retorno
Una cadena con todos los elementos de la matriz unidos. Siarr.length es0, se devuelve la cadena vacía.
Descripción
Las conversiones de cadena de todos los elementos de la matriz se unen en una cadena.
Advertencia:Si un elementono está definido o esnulo, se convierte en la cadena vacía.
Ejemplos
Uniendo un arreglo cuatro veces en diferentes formas
El siguiente ejemplo crea un arregloa con tres elementos para luego unir el arreglo cuatro veces: usando el separador predeterminado, luego una coma y un espacio, luego un signo de suma, y finalmente una cadena vacío.
var a = ["Viento", "Lluvia", "Fuego"];var miVar1 = a.join(); // asigna 'Viento,Lluvia,Fuego' a miVar1var miVar2 = a.join(", "); // asigna 'Viento, Lluvia, Fuego' a miVar2var miVar3 = a.join(" + "); // asigna 'Viento + Lluvia + Fuego' a miVar3var miVar4 = a.join(""); // asigna 'VientoLluviaFuego' a miVar4Unirse a un objeto tipo matriz
El siguiente ejemplo une un objeto parecido a una matriz (argumentos), llamando aFunction.prototype.call enArray.prototype.join.
function f(a, b, c) { var s = Array.prototype.join.call(arguments); console.log(s); // '1,a,true'}f(1, "a", true);//resultado esperado: "1,a,true"Especificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.join |