los join() El método crea y devuelve una nueva cadena concatenando todos los elementos en una matriz (o una objeto similar a una matriz), separados por comas o una cadena de separación especificada. Si la matriz tiene solo un elemento, ese elemento se devolverá sin usar el separador.

Sintaxis

join()
join(separator)

Parámetros

separator Opcional
Especifica una cadena para separar cada par de elementos adyacentes de la matriz. El separador se convierte en una cadena si es necesario. Si se omite, los elementos de la matriz se separan con una coma (“,”). Si separator es una cadena vacía, todos los elementos se unen sin ningún carácter entre ellos.

Valor devuelto

Una cadena con todos los elementos de la matriz unidos. Si arr.length es 0, se devuelve la cadena vacía.

Descripción

Las conversiones de cadena de todos los elementos de la matriz se unen en una sola cadena.

Advertencia: Si un elemento es undefined, null o una matriz vacía [], se convierte en una cadena vacía.

Ejemplos de

Unir una matriz de cuatro formas diferentes

El siguiente ejemplo crea una matriz, a, con tres elementos, luego une la matriz cuatro veces: usando el separador predeterminado, luego una coma y un espacio, luego un signo más y una cadena vacía.

var a = ['Wind', 'Water', 'Fire'];
a.join();      // 'Wind,Water,Fire'
a.join(', ');  // 'Wind, Water, Fire'
a.join(' + '); // 'Wind + Water + Fire'
a.join('');    // 'WindWaterFire'

Unirse a un objeto similar a una matriz

El siguiente ejemplo une un objeto similar a una matriz (arguments), llamando Function.prototype.call sobre Array.prototype.join.

function f(a, b, c) {
  var s = Array.prototype.join.call(arguments);
  console.log(s); // '1,a,true'
}
f(1, 'a', true);
//expected output: "1,a,true"

Especificaciones

Especificación
ECMAScript (ECMA-262)
La definición de ‘Array.prototype.join’ en esa especificación.

Compatibilidad del navegador

Escritorio Móvil
Cromo Borde Firefox explorador de Internet Ópera Safari WebView Android Chrome Android Firefox para Android Opera Android Safari en IOS Internet de Samsung
join 1 12 1 5.5 4 1 1 18 4 10.1 1 1.0

Ver también

  • String.prototype.split()
  • Array.prototype.toString()
  • TypedArray.prototype.join()