WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.entries: eigene Schlüssel-Wert-Paare

Object.entries gibt ein neues Array mit Paaren für aufzählbare eigene Eigenschaften mit Stringschlüsseln zurück.

Version: ECMAScript 2017 onward; example target: Node.js 24.22.2

Syntax

Object.entries(value)

Object.entries(value) führt zuerst ToObject aus: null und undefined werfen TypeError, andere primitive Werte werden verpackt. Ein String liefert deshalb Paare für seine aufzählbaren Zeichenindizes. Das Ergebnis ist ein neues Array aus zweielementigen Arrays [key, value] mit Stringschlüsseln.

Enthalten sind nur aufzählbare eigene Eigenschaften mit Stringschlüsseln. Symbolschlüssel, geerbte und nicht aufzählbare Eigenschaften werden ausgelassen. Die Reihenfolge folgt OwnPropertyKeys: Arrayindex-Schlüssel steigen numerisch, andere Stringschlüssel behalten ihre Erzeugungsreihenfolge.

Die Methode existiert seit ECMAScript 2017. Die Schlüsselliste wird zunächst als Momentaufnahme erfasst; für jeden Schlüssel wird aber sein aktueller eigener Deskriptor erneut geprüft und danach der Wert gelesen. Getter und Proxy-Fallen können das Objekt ändern, spätere Schlüssel löschen oder werfen; das Ergebnis ist keine atomare Momentaufnahme der Werte.

Beispiele

const symbol = Symbol("skip");
const proto = { inherited: "skip" };
const record = Object.create(proto);
Object.defineProperty(record, "first", {
  enumerable: true,
  configurable: true,
  get() { delete record.later; return "A"; }
});
record.later = "B";
record[2] = "two";
record[1] = "one";
Object.defineProperty(record, "hidden", { value: 0 });
record[symbol] = "symbol";
console.log(JSON.stringify(Object.entries(record)));
console.log(JSON.stringify(Object.entries("hi")));
try { Object.entries(null); } catch (error) { console.log(error.name); }

Ergebnis

[["1","one"],["2","two"],["first","A"]]
[["0","h"],["1","i"]]
TypeError

Das Beispiel zeigt Reihenfolge, ausgelassene Symbole und Vererbung sowie einen Getter, der einen späteren Schlüssel löscht.

Quellen