База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Object.entries: собствени двойки ключ–стойност

Object.entries връща нов масив от двойки за enumerable собствени свойства със string ключове.

Версия: ECMAScript 2017 onward; example target: Node.js 24.22.2

Синтаксис

Object.entries(value)

Object.entries(value) първо изпълнява ToObject: null и undefined хвърлят TypeError, а другите примитиви се опаковат. Затова string създава двойки за enumerable индексите на знаците си. Резултатът е нов масив от двуелементни масиви [key, value] със string ключове.

Включват се само enumerable собствени свойства със string ключове. Symbol ключове, inherited и non-enumerable свойства се пропускат. Редът следва OwnPropertyKeys: array-index ключовете са в нарастващ числов ред, а другите string ключове пазят реда на създаване.

Методът съществува от ECMAScript 2017. Списъкът с ключове първо се заснема, но за всеки ключ методът отново проверява текущия му собствен descriptor и после прочита стойността. Getters и Proxy traps могат да променят обекта, да изтрият по-късни ключове или да хвърлят; резултатът не е atomic snapshot на стойностите.

Примери

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); }

Резултат

[["1","one"],["2","two"],["first","A"]]
[["0","h"],["1","i"]]
TypeError

Примерът показва реда, пропускането на symbols и inheritance и getter, който изтрива по-късен ключ.

Източници