MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Array.prototype.join()

Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

Sumário

O método join() junta todos os elementos de uma array dentro de uma string.

Sintaxe

str = arr.join([separador = ','])

Parâmetros

separador
Opcional. Específica uma string para separar cada elemento da array. O separador é convertido em uma string se necessário. Se omitido, os elementos da 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.

Descrição

As conversões em string de todos os elementos de uma array são juntados em apenas uma string.

Exemplos

Exemplo: Juntando uma array de quatro formas diferentes

O exemplo a seguir cria uma array, a, com três elementos, então junta a array através de quatro maneiras: usando o separador padrão, depois com vírgula e espaço, depois com um sinal de soma, e finalmente com uma string vazia.

var a = ['Wind', 'Rain', 'Fire'];
var myVar1 = a.join();      // insere 'Wind,Rain,Fire' em myVar1
var myVar2 = a.join(', ');  // insere 'Wind, Rain, Fire' em myVar2
var myVar3 = a.join(' + '); // insere 'Wind + Rain + Fire' em myVar3
var myVar4 = a.join('');   //  insere 'WindRainFire' em myVar4

Especificações

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

Compatibilidade com o Browser

Função Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte Básico 1.0 1.0 (1.7 or earlier) 5.5 (Yes) (Yes)
Função Android Chrome para Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte Básico (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

 

Veja Também

Etiquetas do documento e colaboradores

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