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.