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