Array.prototype.join()

Sumário

O método join() junta todos os elementos de uma array dentro de uma string.

Sintaxe

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

Parâmetros

separador

Opcional. Específica uma string para separar cada elemento da array. O separador é convertido em uma string se necessário. Se omitido, os elementos da 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.

Descrição

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

Exemplos

Exemplo: Juntando uma array de quatro formas diferentes

O exemplo a seguir cria uma array, a, com três elementos, então junta a array através de quatro maneiras: usando o separador padrão, depois com vírgula e espaço, depois com um sinal de soma, e finalmente com uma string vazia.

var a = ['Wind', 'Rain', 'Fire'];
var myVar1 = a.join();      // insere 'Wind,Rain,Fire' em myVar1
var myVar2 = a.join(', ');  // insere 'Wind, Rain, Fire' em myVar2
var myVar3 = a.join(' + '); // insere 'Wind + Rain + Fire' em myVar3
var myVar4 = a.join('');   //  insere 'WindRainFire' em myVar4

Especificações

Compatibilidade com o Browser

Veja Também

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