Array.prototype.join()

Experimente

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"

Sintaxe

arr.join([separador = ','])

Parâmetros

separador Optional

Específica uma string para separar cada elemento adjacente do array. O separador é convertido em uma string se necessário. Se omitido, os elementos do array são separados com uma vírgula (","). Se o separador for uma string vazia, todos os elementos são juntados sem nenhum caracter entre eles.

Valor de retorno

Uma string com todos os elementos do array juntos. Se arr.length é 0, uma string vazia é retornada.

Descrição

As conversões em string de todos os elementos de um array são juntados em apenas uma string.

Exemplos

Juntando um array de quatro formas diferentes

O exemplo interativo a seguir cria um array, a, com três elementos, e o junta três vezes: a primeira com virgulas, a segunda so junta os elementos e a terceira com um sinal de menos.

Experimente

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"

Juntando um array-like object (objeto estilo-array)

O exemplo abaixo junta um array-like object (ex: o objeto arguments), chamando Function.prototype.call no 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);
//saida esperada: "1,a,true"

Especificações

Compatibilidade com navegadores

Veja Também

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