Array.prototype.join()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Experimente

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.

Aviso: 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.

Experimente

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.

js
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

Specification
ECMAScript Language Specification
# sec-array.prototype.join

Compatibilidade com navegadores

BCD tables only load in the browser

Veja Também