Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources