Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Object.entries: własne pary klucz–wartość

Object.entries zwraca nową tablicę par dla wyliczalnych własnych właściwości o kluczach tekstowych.

Wersja: ECMAScript 2017 onward; example target: Node.js 24.22.2

Składnia

Object.entries(value)

Object.entries(value) najpierw wykonuje ToObject: null i undefined powodują TypeError, a inne wartości pierwotne są opakowywane. Dlatego tekst daje pary dla wyliczalnych indeksów znaków. Wynikiem jest nowa tablica dwuelementowych tablic [key, value]; klucze są tekstami.

Uwzględniane są tylko wyliczalne własne właściwości o kluczach tekstowych. Klucze symboliczne, właściwości odziedziczone i niewyliczalne są pomijane. Kolejność wynika z OwnPropertyKeys: indeksy tablicowe rosną numerycznie, a pozostałe klucze tekstowe zachowują kolejność utworzenia.

Metoda istnieje od ECMAScript 2017. Lista kluczy jest najpierw migawką, ale dla każdego klucza metoda ponownie sprawdza jego aktualny własny deskryptor, a potem odczytuje wartość. Gettery i pułapki Proxy mogą więc zmieniać obiekt, usuwać późniejsze klucze albo rzucać; wynik nie jest atomową migawką wartości.

Przykłady

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

Wynik

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

Przykład pokazuje kolejność kluczy, pomijanie symboli i dziedziczenia oraz usunięcie późniejszego klucza przez getter.

Źródła