WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array-ähnliche Objekte

Ein array-ähnliches Objekt stellt eine Länge und indizierte Eigenschaften bereit, muss aber weder ein Array noch iterierbar sein. Erfahre, welche Rolle `length` spielt und wie `Array.from()` daraus ein Array erstellt.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const arrayLike = { 0: value0, 1: value1, length: 2 };

Ein array-ähnliches Objekt (array-like) hat üblicherweise eine Eigenschaft length und Elemente, die über Indizes von 0 bis length - 1 erreichbar sind. Das ist weder eine eigene Klasse noch eine Garantie dafür, dass das Objekt ein Array ist. Ein Beispiel ist arguments innerhalb einer gewöhnlichen Funktion; es erbt keine Array-Methoden wie map().

Die Eigenschaft length eines array-ähnlichen Objekts gibt dessen Länge an. Array-Methoden normalisieren sie auf eine ganze Zahl zwischen 0 und 2 ** 53 - 1. Es müssen nicht alle Indizes vorhanden sein. Bei einem gewöhnlichen Objekt aktualisiert das Hinzufügen eines Indexes length nicht automatisch, und das Verringern von length löscht keine Eigenschaften – anders als bei einem Array.

Array-Ähnlichkeit und Iterierbarkeit sind voneinander unabhängige Eigenschaften. Eine length-Eigenschaft allein stellt nicht die Methode [Symbol.iterator]() bereit, die für for...of und die Syntax [...value] erforderlich ist. Array.from() verwendet die Iterator-Methode, wenn sie aufrufbar ist. Nur wenn die Eigenschaft Symbol.iterator fehlt oder den Wert undefined oder null hat, liest Array.from() die Eigenschaft length und die indizierten Eigenschaften aus. Hat Symbol.iterator einen anderen nicht aufrufbaren Wert wie false, löst Array.from() einen TypeError aus, bevor es length liest. Beim Lesen über Indizes wird ein fehlender Index im neuen Array zu einem vorhandenen Element mit dem Wert undefined.

Viele Array-Methoden lassen sich ausleihen, zum Beispiel mit Array.prototype.map.call(arrayLike, fn), aber nicht jede Methode ist generisch. Die Umwandlung mit Array.from() selbst verwendet nur ECMAScript und benötigt keine DOM-APIs. Zur Ausgabe der Ergebnisse verwendet das Beispiel console.log, das von der Laufzeitumgebung bereitgestellt wird. Dass das Beispiel in Node.js funktioniert, belegt nicht, dass Browser-APIs unterstützt werden.

Beispiele

const arrayLike = { 0: "A", 2: "C", length: 3 };
const values = Array.from(arrayLike);

console.log(Array.isArray(arrayLike));
console.log(typeof arrayLike[Symbol.iterator]);
console.log(values.length);
console.log(values[0], values[1], values[2]);
console.log(1 in values);

Ergebnis

false
undefined
3
A undefined C
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen