Array.prototype.join()

O método join() junta todos os elementos de um array (ou um array-like object) em uma string e retorna esta string.

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.

Obs: Se um elemento é undefined ou null, ele é convertido em uma string vazia.

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.

 

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 o Browser

BCD tables only load in the browser

Veja Também