CKTIS / JavaScript
Object.fromEntries — objekt iz parov ključ–vrednost
Object.fromEntries ustvari nov objekt iz iterabilne zbirke vnosov ključ–vrednost. Podpira besedilne ključe in simbole; pri ponovljenih ključih obdrži zadnjo vrednost. Uporaben je za pretvarjanje vnosov ali Map v objekt.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Object.fromEntries(iterable)Object.fromEntries(iterable) je statična metoda, uvedena v ECMAScript 2019, in ne spletni API. Sprejme iterabilen objekt, na primer polje parov ali Map, ter vrne nov običajen objekt s prototipom Object.prototype. Razpoložljivost v ciljnem okolju preverite z typeof Object.fromEntries === "function"; različica Node, uporabljena v repozitoriju, ne dokazuje podpore v brskalnikih.
Vsak vnos mora biti objekt: metoda prebere njegovi lastnosti 0 in 1 kot ključ in vrednost. Sami vnosi niso nujno iterabilni. Če lastnost 1 manjka, je vrednost undefined; dodatni elementi se prezrejo. Neiterabilen vhod ali primitivni vnos povzroči TypeError.
Pri pretvorbi v ključ lastnosti metoda ključ najprej pretvori v primitivno vrednost, če je ključ objekt. Če je primitivna vrednost simbol, se uporabi nespremenjena; sicer se pretvori v niz. Če se ključi po pretvorbi ponovijo, velja zadnja vrednost. Rezultat ima lastne podatkovne lastnosti, ki so zapisljive, naštete in nastavljive. Vnos "__proto__" ustvari lastno lastnost, namesto da bi spremenil prototip.
Pogost postopek je Object.entries(obj), nato map ali filter in nazadnje Object.fromEntries(...). To ni popolna obratna pretvorba: Object.entries izpusti simbole in lastnosti, ki jih ni mogoče naštevati, deskriptorji pa se ne ohranijo. Vrednosti, ki so objekti, ostanejo reference — globoka kopija ne nastane.
Primeri
const token = Symbol("token");
const entries = [["score", 10], ["score", 20], [token, "ok"]];
const result = Object.fromEntries(entries);
console.log(result.score);
console.log(result[token]);
console.log(Object.entries(result).length);Rezultat
20 ok 1
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.