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

CKTIS / JavaScript

Reflect.ownKeys — toutes les clés propres d’un objet

Reflect.ownKeys(target) exige un objet. Pour un objet ordinaire, la méthode renvoie un tableau de toutes les clés propres : chaînes et symboles, y compris les clés des propriétés non énumérables. Les propriétés héritées sont exclues. Le piège ownKeys d’un Proxy peut modifier les clés renvoyées.

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

Reflect.ownKeys(target)

Reflect.ownKeys(target) crée un nouveau tableau de clés. Si target est un objet ordinaire, le tableau contient les clés de toutes ses propriétés propres, énumérables ou non. Ses éléments sont des chaînes ou des symboles, et non les valeurs des propriétés. La chaîne des prototypes n’est pas parcourue. Un argument qui n’est pas un objet, y compris null ou une chaîne, provoque une TypeError ; il n’est pas automatiquement converti en objet.

Pour les objets ordinaires, les clés qui sont des indices de tableau viennent d’abord, par ordre numérique croissant, puis les autres chaînes dans l’ordre de création des propriétés, et enfin les symboles dans l’ordre de création des propriétés correspondantes. Ainsi, "2" précède "10", même si ces clés ont été ajoutées dans l’ordre inverse ; les clés elles-mêmes restent des chaînes.

À l’inverse, Object.keys renvoie uniquement les clés énumérables de type chaîne. Object.getOwnPropertyNames inclut les clés propres de type chaîne, tandis que Object.getOwnPropertySymbols inclut les symboles propres. Utilisez Reflect.ownKeys lorsque vous avez besoin des deux types de clés sans filtrer selon leur énumérabilité.

La méthode appelle l’opération interne [[OwnPropertyKeys]]. Avec un Proxy, cela peut déclencher le piège ownKeys : du code utilisateur peut alors être exécuté, une exception peut être levée ou les clés peuvent être renvoyées dans un ordre autorisé différent de celui d’un objet ordinaire. Le piège peut aussi modifier l’ensemble des clés renvoyées : si la cible du proxy est extensible, il peut omettre des clés de propriétés propres configurables ou renvoyer des clés supplémentaires pour lesquelles la cible n’a pas de descripteur de propriété propre. Il doit inclure les clés des propriétés propres non configurables. Si la cible n’est pas extensible, l’ensemble renvoyé doit correspondre exactement à celui de ses clés propres. Ne supposez pas que tous les objets exotiques suivent l’ordre ordinaire. Il s’agit d’une API du langage ECMAScript ; la simple présence de Node 24 dans un dépôt ne prouve pas sa prise en charge par le navigateur cible.

Exemples

const tag = Symbol("tag");
const target = Object.create({ inherited: true });
target["10"] = "ten";
target["2"] = "two";
target.name = "Ada";
Object.defineProperty(target, "hidden", { value: 42 });
target[tag] = "metadata";

const keys = Reflect.ownKeys(target);
console.log(keys.map(key => String(key)).join(" | "));
console.log(keys[keys.length - 1] === tag);

Résultat

2 | 10 | name | hidden | Symbol(tag)
true

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.

Sources