Array.prototype.join()

Probieren Sie es aus

const elements = ["Fire", "Air", "Water"];

console.log(elements.join());
// Expected output: "Fire,Air,Water"

console.log(elements.join(""));
// Expected output: "FireAirWater"

console.log(elements.join("-"));
// Expected output: "Fire-Air-Water"

Syntax

join()
join(separator)

Parameter

separator Optional

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

Rckgabewert

Ein String, in dem alle Array-Elemente verknpft sind. Wenn array.length 0 ist, wird der leere String zurckgegeben.

Beschreibung

Die String-Konvertierungen aller Array-Elemente werden zu einem String verbunden. Wenn ein Element undefined oder null ist, wird es in einen leeren String umgewandelt, anstatt in den String "null" oder "undefined".

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

Array.prototype.join konvertiert rekursiv jedes Element, einschlielich anderer Arrays, in Strings. Da der von Array.prototype.toString zurckgegebene String (was dem Aufruf von join() entspricht) keine Trennzeichen hat, sehen geschachtelte Arrays so aus, als seien sie flach. Sie knnen nur den Trennstring der ersten Ebene steuern, whrend 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 enthlt 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 auf sparsen Arrays angewendet wird, durchluft die join() Methode leere Pltze, als htten sie den Wert undefined.

Die join() Methode ist generisch. Sie erwartet nur, dass der this Wert eine length Eigenschaft und integerbasierte Schlssel-Eigenschaften hat.

Beispiele

Ein Array auf vier verschiedene Arten verbinden

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 einem leeren String.

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

Verwendung von join() auf sprlichen Arrays

join() behandelt leere Pltze genauso wie undefined und erzeugt ein zustzliches Trennzeichen:

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

Aufruf von join() auf Nicht-Array-Objekten

Die join() Methode liest die length Eigenschaft von this und greift dann auf jede Eigenschaft zu, deren Schlssel 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

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von Array.prototype.join in core-js
• es-shims Polyfill von Array.prototype.join
• Leitfaden fr Indexierte Sammlungen
• Array
• Array.prototype.toString()
• TypedArray.prototype.join()
• String.prototype.split()