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.