CKTIS / JavaScript
Object.keys — clés propres énumérables d’un objet
Object.keys(obj) renvoie un nouveau tableau contenant les clés propres énumérables d’un objet, sous forme de chaînes. Les propriétés héritées ou non énumérables, ainsi que les clés Symbol, sont exclues. Pour les objets ordinaires, les clés correspondant à des indices de tableau apparaissent avant les autres clés chaîne.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Object.keys(obj)Object.keys(obj) est une méthode statique de Object qui renvoie un nouveau tableau de noms de propriétés. Elle ne prend en compte que les propriétés propres, c’est-à-dire celles qui ne sont pas héritées d’un prototype, dont l’attribut enumerable vaut true et dont la clé est une chaîne. Le résultat contient des chaînes, même si les clés ont été écrites sous forme de nombres. Les clés Symbol sont exclues.
Pour les objets ordinaires, les clés correspondant à des indices de tableau apparaissent par ordre numérique croissant, puis les autres clés chaîne suivent leur ordre de création. Il ne s’agit ni d’un tri alphabétique ni d’une règle applicable à toute chaîne ressemblant à un nombre : "02" n’est pas un indice de tableau. Les objets Proxy peuvent influer sur l’ordre et exécuter du code pendant l’énumération.
Contrairement à for...in, cette méthode exclut les propriétés énumérables héritées. En revanche, Reflect.ownKeys(obj) inclut aussi les propriétés propres non énumérables et les clés Symbol. Object.keys ne lit pas les valeurs des propriétés et n’appelle pas leurs accesseurs ; le tableau renvoyé n’est pas mis à jour lorsque l’objet change.
null et undefined provoquent une TypeError. Les autres valeurs primitives sont converties en objets : Object.keys("ab") produit ["0","1"], tandis que Object.keys(42) produit []. Il s’agit d’une API du langage ECMAScript, et non d’une API de navigateur ; exécuter l’exemple dans Node.js ne prouve pas sa compatibilité avec un navigateur particulier.
Exemples
const item = Object.create({ inherited: true });
item.name = "Ada";
item[10] = "ten";
item[2] = "two";
Object.defineProperty(item, "hidden", { value: true });
item[Symbol("tag")] = true;
console.log(JSON.stringify(Object.keys(item)));Résultat
["2","10","name"]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.