Array.prototype.join()

separator Optional

Eine Zeichenkette, um jedes Paar benachbarter Elemente des Arrays zu trennen. Wenn nicht angegeben, werden die Array-Elemente mit einem Komma (",") getrennt.

Eine Zeichenkette, die alle Array-Elemente verbindet. Wenn array.length 0 ist, wird die leere Zeichenkette zurückgegeben.

Die Zeichenkettenkonvertierungen aller Array-Elemente werden zu einer Zeichenkette verbunden. Wenn ein Element undefined oder null ist, wird es in eine leere Zeichenkette anstelle der Zeichenkette "null" oder "undefined" konvertiert.

Die join-Methode wird intern von Array.prototype.toString() ohne Argumente aufgerufen. Das Überschreiben von join einer Array-Instanz wird auch ihr toString-Verhalten überschreiben.

Array.prototype.join konvertiert rekursiv jedes Element, einschließlich anderer Arrays, zu Zeichenketten. Da die von Array.prototype.toString zurückgegebene Zeichenkette (die der Aufruf von join() entspricht) keine Trennzeichen hat, wirken verschachtelte Arrays wie flach. Sie können nur das Trennzeichen der ersten Ebene steuern, während tiefere Ebenen immer das Standardkomma verwenden.

const matrix = [
  [1, 2, 3],
  [4, 5, 6],
  [7, 8, 9],
];

console.log(matrix.join()); // 1,2,3,4,5,6,7,8,9
console.log(matrix.join(";")); // 1,2,3;4,5,6;7,8,9

Wenn ein Array zyklisch ist (es enthält ein Element, das es selbst ist), vermeiden Browser eine unendliche Rekursion, indem sie die zyklische Referenz ignorieren.

const arr = [];
arr.push(1, [3, arr, 4], 2);
console.log(arr.join(";")); // 1;3,,4;2

Wenn die Methode bei sparsamen Arrays verwendet wird, iteriert die join()-Methode leere Slots, als ob sie den Wert undefined hätten.

Die join()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und ganzzahlige Schlüssel-Eigenschaften hat.

Das folgende Beispiel erstellt ein Array a mit drei Elementen und verbindet es dann viermal: einmal mit dem Standardtrennzeichen, dann mit einem Komma und einem Leerzeichen, dann mit einem Pluszeichen und einer leeren Zeichenkette.

const a = ["Wind", "Water", "Fire"];
a.join(); // 'Wind,Water,Fire'
a.join(", "); // 'Wind, Water, Fire'
a.join(" + "); // 'Wind + Water + Fire'
a.join(""); // 'WindWaterFire'

join() behandelt leere Slots genauso wie undefined und erzeugt ein zusätzliches Trennzeichen:

console.log([1, , 3].join()); // '1,,3'
console.log([1, undefined, 3].join()); // '1,,3'

Die join()-Methode liest die length-Eigenschaft von this und greift dann auf jede Eigenschaft zu, deren Schlüssel eine nicht-negative Ganzzahl kleiner als length ist.

const arrayLike = {
  length: 3,
  0: 2,
  1: 3,
  2: 4,
  3: 5, // ignored by join() since length is 3
};
console.log(Array.prototype.join.call(arrayLike));
// 2,3,4
console.log(Array.prototype.join.call(arrayLike, "."));
// 2.3.4

• Polyfill von Array.prototype.join in core-js
• es-shims Polyfill von Array.prototype.join
• Anleitung zu indizierten Sammlungen
• Array
• Array.prototype.toString()
• TypedArray.prototype.join()
• String.prototype.split()