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

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.

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.

 

 

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

Especificação Status Comentário
ECMAScript 1st Edition (ECMA-262) Padrão Definição inicial. Implementado em JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Padrão  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Padrão  
ECMAScript Latest Draft (ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Rascunho  

Compatibilidade com o Browser

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung InternetNode.js
Basic supportChrome Full support 1Edge Full support YesFirefox Full support 1IE Full support 5.5Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yesnodejs Full support Yes

Legend

Full support  
Full support

Veja Também

Etiquetas do documento e colaboradores

Colaboradores desta página: Grohden, ZavarezeH
Última atualização por: Grohden,