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