Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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č.

Viri