CKTIS / JavaScript
Object.entries: lastni pari ključ–vrednost
Object.entries vrne novo polje parov za naštevne lastne lastnosti z nizovnimi ključi.
Različica: ECMAScript 2017 onward; example target: Node.js 24.22.2
Sintaksa
Object.entries(value)Object.entries(value) najprej izvede ToObject: null in undefined sprožita TypeError, druge primitivne vrednosti pa se ovijejo. Niz zato ustvari pare za naštevne indekse znakov. Rezultat je novo polje dvoelementnih polj [key, value] z nizovnimi ključi.
Vključene so samo naštevne lastne lastnosti z nizovnimi ključi. Simbolni ključi, podedovane in nenaštevne lastnosti so izpuščeni. Vrstni red sledi OwnPropertyKeys: indeksi polja naraščajo številčno, drugi nizovni ključi pa ohranijo vrstni red nastanka.
Metoda obstaja od ECMAScript 2017. Seznam ključev se najprej zajame, vendar metoda za vsak ključ znova preveri njegov trenutni lastni deskriptor in nato pridobi vrednost. Getterji in pasti Proxy lahko zato spremenijo objekt, izbrišejo poznejše ključe ali sprožijo izjemo; rezultat ni atomski posnetek vrednosti.
Primeri
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); }Rezultat
[["1","one"],["2","two"],["first","A"]] [["0","h"],["1","i"]] TypeError
Primer pokaže vrstni red, izpustitev simbolov in dedovanja ter getter, ki izbriše poznejši ključ.