WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.join: Elemente zu einer Zeichenkette verbinden

join wandelt Elemente in Text um und verbindet sie; Lücken, null und undefined werden zu leeren Teilen.

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

Syntax

array.join([separator])

array.join([separator]) liefert eine Zeichenkette. Standardseparator ist das Komma; ein angegebener Separator wird in Text umgewandelt. Elemente werden gelesen und konvertiert, doch null, undefined und Lücken ergeben leere Teile. Ein verschachteltes Array verwendet sein toString, daher erscheint innen meist ein Komma.

Die Methode mutiert nicht und ist für array-ähnliche Objekte generisch. Ein leeres Array ergibt den leeren String, ein Element keinen Separator. Getter- oder Konvertierungsfehler werden weitergegeben; ein Symbol kann bei abstrakter String-Konvertierung TypeError auslösen. Das Beispiel zeigt leere Teile und einen unabhängigen äußeren Separator.

Beispiele

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

Ergebnis

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

Quellen