CKTIS / JavaScript
Object.getOwnPropertyNames — noms des propriétés propres
Object.getOwnPropertyNames(obj) renvoie dans un nouveau tableau des clés de type chaîne. Pour un objet ordinaire, ce sont les clés de toutes les propriétés propres qui ont ce type de clé, y compris les propriétés non énumérables. Les clés Symbol sont exclues, et le piège ownKeys d’un Proxy peut influer sur la liste.
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.getOwnPropertyNames(obj)Object.getOwnPropertyNames(obj) est une méthode statique : appelez-la sur Object, et non sur l’objet inspecté. Elle renvoie un nouveau tableau qui ne contient que les clés de type chaîne issues de l’opération interne [[OwnPropertyKeys]], sans vérifier les descripteurs de propriétés. Pour les objets ordinaires, le tableau contient toutes les clés de type chaîne des propriétés propres, indépendamment de l’attribut enumerable, mais aucune clé de propriété héritée. La méthode renvoie des clés, pas des valeurs de propriétés.
Pour les objets ordinaires, Object.keys(obj) ne prend en compte que les propriétés propres énumérables dont les clés sont des chaînes. Object.getOwnPropertySymbols(obj) renvoie les clés Symbol des propriétés propres, tandis que Reflect.ownKeys(obj) renvoie les clés des propriétés propres, qu’il s’agisse de chaînes ou de Symbol, y compris celles des propriétés non énumérables. « Propre » et « énumérable » désignent des caractéristiques différentes.
Pour les objets ordinaires, les noms correspondant à des indices de tableau apparaissent d’abord, dans l’ordre numérique croissant ; les autres clés de type chaîne suivent l’ordre de création des propriétés. Il ne s’agit pas d’un tri alphabétique. Les objets Proxy peuvent personnaliser la liste et son ordre via le piège ownKeys, sous réserve des contraintes de la spécification. Si l’objet cible est extensible, le piège peut signaler une clé de type chaîne à laquelle ne correspond aucun descripteur de propriété propre, ou omettre la clé de type chaîne d’une propriété propre configurable de la cible.
null et undefined provoquent un TypeError ; les autres valeurs primitives sont converties en objets. L’exemple montre l’ordre des indices et l’inclusion de hidden, qui est non énumérable par défaut avec cette utilisation de Object.defineProperty. La propriété inherited et la clé Symbol sont exclues.
Exemples
const obj = Object.create({ inherited: true });
obj[10] = 'ten';
obj[2] = 'two';
obj.label = 'demo';
Object.defineProperty(obj, 'hidden', { value: 42 });
obj[Symbol('token')] = 'secret';
console.log(JSON.stringify(Object.getOwnPropertyNames(obj)));
console.log(JSON.stringify(Object.keys(obj)));Résultat
["2","10","label","hidden"] ["2","10","label"]
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.