Array.of()

Probieren Sie es aus

console.log(Array.of("foo", 2, "bar", true));
// Expected output: Array ["foo", 2, "bar", true]

console.log(Array.of());
// Expected output: Array []

Syntax

Array.of()
Array.of(element1)
Array.of(element1, element2)
Array.of(element1, element2, /* , */ elementN)

Parameter

element1, , elementN

Elemente, die zur Erstellung des Arrays verwendet werden.

Rckgabewert

Eine neue Array-Instanz.

Beschreibung

Der Unterschied zwischen Array.of() und dem Array()-Konstruktor liegt in der Behandlung einzelner Argumente: Array.of(7) erstellt ein Array mit einem einzigen Element, 7, whrend Array(7) ein leeres Array mit einer length-Eigenschaft von 7 erstellt. (Das bedeutet ein Array mit 7 leeren Slots, nicht mit tatschlichen undefined-Werten.)

Array.of(7); // [7]
Array(7); // array of 7 empty slots

Array.of(1, 2, 3); // [1, 2, 3]
Array(1, 2, 3); // [1, 2, 3]

Die Methode Array.of() ist eine generische Fabrikmethode. Wenn zum Beispiel eine Unterklasse von Array die of()-Methode erbt, wird die geerbte of()-Methode neue Instanzen der Unterklasse statt Array-Instanzen zurckgeben. Tatschlich kann der this-Wert jede Konstruktorfunktion sein, die ein einzelnes Argument akzeptiert, das die Lnge des neuen Arrays darstellt, und der Konstruktor wird mit der Anzahl der an of() bergebenen Argumente aufgerufen. Die endgltige length wird erneut festgelegt, wenn alle Elemente zugewiesen sind. Wenn der this-Wert keine Konstruktorfunktion ist, wird stattdessen der einfache Array-Konstruktor verwendet.

Beispiele

Verwendung von Array.of()

Array.of(1); // [1]
Array.of(1, 2, 3); // [1, 2, 3]
Array.of(undefined); // [undefined]

Aufrufen von of() auf Nicht-Array-Konstruktoren

Die of()-Methode kann auf jede Konstruktorfunktion aufgerufen werden, die ein einzelnes Argument akzeptiert, das die Lnge des neuen Arrays darstellt.

function NotArray(len) {
  console.log("NotArray called with length", len);
}

console.log(Array.of.call(NotArray, 1, 2, 3));
// NotArray called with length 3
// NotArray { '0': 1, '1': 2, '2': 3, length: 3 }

console.log(Array.of.call(Object)); // [Number: 0] { length: 0 }

Wenn der this-Wert kein Konstruktor ist, wird ein einfacher Array-Datentyp zurckgegeben.

console.log(Array.of.call({}, 1)); // [ 1 ]

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von Array.of in core-js
• es-shims Polyfill von Array.of
• Leitfaden fr indizierte Sammlungen
• Array
• Array()
• Array.from()
• TypedArray.of()