CKTIS / JavaScript
Object.entries: eigen sleutel-waardeparen
Object.entries retourneert een nieuwe array met paren voor opsombare eigen eigenschappen met stringsleutels.
Versie: ECMAScript 2017 onward; example target: Node.js 24.22.2
Syntax
Object.entries(value)Object.entries(value) voert eerst ToObject uit: null en undefined werpen TypeError, terwijl andere primitieve waarden worden geboxed. Een string levert daarom paren voor zijn opsombare tekenindices. Het resultaat is een nieuwe array van tweedelige [key, value]-arrays, met stringsleutels.
Alleen opsombare eigen eigenschappen met stringsleutels worden opgenomen. Symboolsleutels, geërfde en niet-opsombare eigenschappen worden overgeslagen. De volgorde volgt OwnPropertyKeys: array-indexsleutels lopen numeriek op en andere stringsleutels behouden hun aanmaakvolgorde.
De methode bestaat sinds ECMAScript 2017. Eerst wordt de sleutellijst vastgelegd, maar voor elke sleutel controleert de methode opnieuw de huidige eigen descriptor en haalt daarna de waarde op. Getters en Proxy-traps kunnen dus het object wijzigen, latere sleutels verwijderen of werpen; het resultaat is geen atomaire momentopname van waarden.
Voorbeelden
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); }Resultaat
[["1","one"],["2","two"],["first","A"]] [["0","h"],["1","i"]] TypeError
Het voorbeeld toont volgorde, weglaten van symbolen en overerving, en een getter die een latere sleutel verwijdert.