CKTIS / JavaScript
Object.entries: vlastné dvojice kľúč–hodnota
Object.entries vracia nové pole dvojíc pre vyčísliteľné vlastné vlastnosti s reťazcovými kľúčmi.
Verzia: ECMAScript 2017 onward; example target: Node.js 24.22.2
Syntax
Object.entries(value)Object.entries(value) najprv vykoná ToObject: null a undefined vyvolajú TypeError, ostatné primitívne hodnoty sa zabalia. Reťazec preto vytvorí dvojice pre vyčísliteľné indexy znakov. Výsledkom je nové pole dvojprvkových polí [key, value] s reťazcovými kľúčmi.
Zahrnuté sú len vyčísliteľné vlastné vlastnosti s reťazcovými kľúčmi. Symboly, zdedené a nevyčísliteľné vlastnosti sa vynechajú. Poradie určuje OwnPropertyKeys: kľúče indexov poľa rastú číselne, ostatné reťazce zachovávajú poradie vytvorenia.
Metóda existuje od ECMAScript 2017. Zoznam kľúčov sa najprv zachytí, ale pri každom kľúči metóda znovu overí jeho aktuálny vlastný deskriptor a potom načíta hodnotu. Gettery a pasce Proxy tak môžu objekt meniť, mazať neskoršie kľúče alebo vyvolať výnimku; výsledok nie je atómová snímka hodnôt.
Prí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ýsledok
[["1","one"],["2","two"],["first","A"]] [["0","h"],["1","i"]] TypeError
Príklad ukazuje poradie, vynechanie symbolov a dedenia a getter, ktorý zmaže neskorší kľúč.