Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Array.prototype.join: unir elementos numa string

join converte elementos em texto e une-os; posições vazias, null e undefined tornam-se fragmentos vazios.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

array.join([separator])

array.join([separator]) devolve uma string. O separador predefinido é vírgula; um separador fornecido é convertido em texto. Cada elemento é lido e convertido, exceto null, undefined e uma posição vazia, que produzem fragmento vazio. Um array aninhado usa o seu toString, logo costuma surgir uma vírgula interna.

Não altera o recetor e é genérico para objetos array-like. Um array vazio dá string vazia e um elemento não acrescenta separador. Erros de getter ou conversão propagam-se; um Symbol pode lançar TypeError. O exemplo mostra fragmentos vazios e um separador exterior independente.

Exemplos

console.log([1, null, , 3].join("|"));
console.log([[1, 2], [3]].join(";"));
console.log(JSON.stringify([].join("-")));

Resultado

1|||3
1,2;3
""

Fontes