Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje