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