KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Array.prototype.join: elementen tot een tekenreeks verbinden

join zet elementen om in tekst en verbindt ze; gaten, null en undefined worden lege stukken.

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

Syntax

array.join([separator])

array.join([separator]) retourneert één tekenreeks. Standaard is de scheiding een komma; een opgegeven separator wordt tekst. Elk element wordt gelezen en geconverteerd, behalve null, undefined en een gat, die een leeg stuk geven. Een geneste array gebruikt haar eigen toString, zodat binnenin meestal een komma verschijnt.

De methode muteert niet en is generiek voor array-achtige objecten. Een lege array geeft een lege string en één element geen separator. Getter- of conversiefouten worden doorgegeven; een Symbol kan TypeError werpen. Het voorbeeld toont lege stukken en een onafhankelijke buitenste separator.

Voorbeelden

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

Resultaat

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

Bronnen