Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.join: unire elementi in una stringa

join converte gli elementi in testo e li unisce; vuoti, null e undefined diventano frammenti vuoti.

Versione: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintassi

array.join([separator])

array.join([separator]) restituisce una stringa. Il separatore predefinito è la virgola; quello fornito viene convertito in testo. Ogni elemento è letto e convertito, tranne null, undefined e un vuoto che producono un frammento vuoto. Un array annidato usa il proprio toString, quindi normalmente appare una virgola interna.

Non muta il ricevente ed è generico per oggetti array-like. Un array vuoto dà stringa vuota e un solo elemento non aggiunge separatore. Errori di getter o conversione si propagano; un Symbol può generare TypeError. L’esempio mostra frammenti vuoti e un separatore esterno indipendente.

Esempi

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

Risultato

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

Fonti