Array.prototype.join()

separator Optional

Eine Zeichenkette, die jedes Paar angrenzender Elemente des Arrays trennt. Wenn sie weggelassen wird, werden die Array-Elemente mit einem Komma (",") getrennt.

Eine Zeichenkette mit allen verbundenen Array-Elementen. Wenn array.length 0 ist, wird die leere Zeichenkette zurückgegeben.

Die Zeichenketten-Konvertierungen aller Array-Elemente werden in eine Zeichenkette zusammengeführt. Wenn ein Element undefined oder null ist, wird es in eine leere Zeichenkette umgewandelt, anstatt in die Zeichenketten "null" oder "undefined".

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

Array.prototype.join konvertiert rekursiv jedes Element, einschließlich anderer Arrays, in Zeichenketten. Da die von Array.prototype.toString zurückgegebene Zeichenkette (die dasselbe ist wie ein Aufruf von join()) keine Trennzeichen besitzt, sehen geschachtelte Arrays so aus, als wären sie 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 den zyklischen Verweis ignorieren.

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

Wenn die Methode bei spärlichen Arrays angewendet wird, iteriert die join()-Methode über leere Plätze, als hätten sie den Wert undefined.

Die join()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und Integer-Schlüsseleigenschaften besitzt.

Das folgende Beispiel erstellt ein Array a mit drei Elementen und verbindet dann das Array viermal: Mit dem Standardtrennzeichen, dann mit einem Komma und einem Leerzeichen, dann mit einem Plus 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 Plätze 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 nichtnegative ganze Zahl 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
• Leitfaden für indizierte Sammlungen
• Array
• Array.prototype.toString()
• TypedArray.prototype.join()
• String.prototype.split()