CKTIS / JavaScript
Object.entries: vlastní dvojice klíč–hodnota
Object.entries vrací nové pole dvojic pro vyčíslitelné vlastní vlastnosti s řetězcovými klíči.
Verze: ECMAScript 2017 onward; example target: Node.js 24.22.2
Syntaxe
Object.entries(value)Object.entries(value) nejprve provede ToObject: null a undefined vyvolají TypeError, ostatní primitivní hodnoty se zabalí. Řetězec proto vytvoří dvojice pro vyčíslitelné indexy znaků. Výsledkem je nové pole dvouprvkových polí [key, value] s řetězcovými klíči.
Zahrnuty jsou jen vyčíslitelné vlastní vlastnosti s řetězcovými klíči. Symboly, zděděné a nevyčíslitelné vlastnosti se vynechají. Pořadí určuje OwnPropertyKeys: klíče indexů pole rostou číselně, ostatní řetězce zachovávají pořadí vytvoření.
Metoda existuje od ECMAScript 2017. Seznam klíčů se nejprve zachytí, ale u každého klíče metoda znovu ověří jeho aktuální vlastní deskriptor a pak načte hodnotu. Gettery a pasti Proxy tak mohou objekt měnit, mazat pozdější klíče nebo vyvolat výjimku; výsledek není atomický snímek hodnot.
Příklady
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); }Výsledek
[["1","one"],["2","two"],["first","A"]] [["0","h"],["1","i"]] TypeError
Příklad ukazuje pořadí, vynechání symbolů a dědičnosti a getter, který smaže pozdější klíč.