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()