CKTIS / JavaScript
Object.entries : paires clé–valeur propres
Object.entries renvoie un nouveau tableau de paires pour les propriétés propres énumérables dont la clé est une chaîne.
Version : ECMAScript 2017 onward; example target: Node.js 24.22.2
Syntaxe
Object.entries(value)Object.entries(value) applique d’abord ToObject : null et undefined lèvent TypeError, tandis que les autres primitives sont encapsulées. Une chaîne produit donc des paires pour ses indices de caractères énumérables. Le résultat est un nouveau tableau de tableaux [key, value], avec des clés textuelles.
Seules les propriétés propres énumérables à clé chaîne sont incluses. Les symboles, les propriétés héritées et non énumérables sont ignorés. L’ordre suit OwnPropertyKeys : les indices de tableau croissent numériquement, puis les autres chaînes gardent leur ordre de création.
La méthode existe depuis ECMAScript 2017. La liste des clés est d’abord figée, mais pour chacune la méthode revérifie le descripteur propre courant puis lit la valeur. Getters et pièges Proxy peuvent donc modifier l’objet, supprimer une clé ultérieure ou lever une exception ; le résultat n’est pas un instantané atomique des valeurs.
Exemples
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); }Résultat
[["1","one"],["2","two"],["first","A"]] [["0","h"],["1","i"]] TypeError
L’exemple montre l’ordre, l’omission des symboles et de l’héritage, puis un getter supprimant une clé ultérieure.