MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

O método join() une todos os elementos de um vector (ou objecto semelhante a vector) numa cadeia (de caracteres).

var a = ['Vento', 'Chuva', 'Fogo'];
a.join();    // 'Vento,Chuva,Fogo'
a.join('-'); // 'Vento-Chuva-Fogo'

Sintaxe

vec.join()
vec.join(separador)

Parâmetros

separador Optional
Especifica uma cadeia (de caracteres) para separar cada elemento do vector. O separador é convertido em cadeia se for necessário. Se separador é uma cadeia vazia, todos os elementos são unidos sem qualquer carácter entre eles. É "," por defeito.

Valor devolvido

Uma cadeia (de caracteres) com todos os elementos do vector unidos. Se vec.length é 0, é devolvida uma cadeia vazia.

Descrição

As conversões de todos os elementos do vector para cadeias (de caracteres) são unidas numa única cadeia. Caso algum elemento seja undefined ou null, este será convertido numa cadeia vazia.

Exemplos

Juntando um vector de quatro formas diferentes

O exemplo que se segue cria um vector, a, com três elementos, depois disso une o vector quatro vezes : usando o separador por defeito, uma vírgula e um espaço, o símbolo mais, e finalmente uma cadeia (de caracteres) vazia.

var a = ['Vento', 'Chuva', 'Fogo'];
a.join();      // 'Vento,Chuva,Fogo'
a.join(', ');  // 'Vento, Chuva, Fogo'
a.join(' + '); // 'Vento + Chuva + Fogo'
a.join('');    // 'VentoChuvaFogo'

Especificações

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

Compatibilidade de navegadores

Característica Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico 1.0 (Yes) 1.0 (1.7 or earlier) 5.5 (Yes) (Yes)
Característica Android Chrome for Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte básico (Yes) (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Ver também

Etiquetas do documento e contribuidores

 Contribuidores para esta página: ricardomartins
 Última atualização por: ricardomartins,