Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje