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

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

separadorOptional

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 oseparador 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. Searr.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 objetoarguments), chamandoFunction.prototype.call noArray.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()