CKTIS / JavaScript
Object.getOwnPropertySymbols — clés Symbol propres
Object.getOwnPropertySymbols(obj) renvoie un tableau de clés de type Symbol. Pour les objets ordinaires, il s’agit des clés des propriétés propres, y compris celles qui ne sont pas énumérables. La méthode exclut les clés de type chaîne et ne parcourt pas la chaîne de prototypes.
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.getOwnPropertySymbols(obj)Object.getOwnPropertySymbols(obj) est une méthode statique de Object qui crée un nouveau tableau contenant uniquement les clés de type Symbol de la liste renvoyée par l’opération interne [[OwnPropertyKeys]] de l’objet. Elle renvoie des clés, et non des valeurs ou des descriptions de symboles. Pour lire la valeur d’une propriété, utilisez obj[key].
La méthode exclut les clés de type chaîne et ne parcourt pas la chaîne de prototypes. Elle ne vérifie pas les descripteurs de propriété : un Proxy dont la cible est extensible peut signaler un symbole via son intercepteur ownKeys, même si le proxy n’a pas de descripteur de propriété propre pour ce symbole.
Pour les objets ordinaires, le résultat contient les clés des propriétés propres énumérables et non énumérables, et les symboles apparaissent dans l’ordre de création de ces propriétés. Object.keys(obj) renvoie uniquement les clés de type chaîne des propriétés propres énumérables, Object.getOwnPropertyNames(obj) renvoie toutes les clés propres de type chaîne et Reflect.ownKeys(obj) renvoie les deux types de clés propres.
L’argument est converti en objet ; null et undefined provoquent une TypeError. Les symboles ne garantissent pas la confidentialité : cette méthode permet de découvrir ces clés même lorsque enumerable: false.
Dans l’exemple, le résultat contient visible et hidden, mais ni inherited ni name. Les comparaisons vérifient l’identité des symboles, et la dernière ligne lit les valeurs des propriétés correspondantes.
Exemples
const inherited = Symbol('inherited');
const visible = Symbol('visible');
const hidden = Symbol('hidden');
const obj = Object.create({ [inherited]: 10 });
obj.name = 'demo';
obj[visible] = 20;
Object.defineProperty(obj, hidden, {
value: 30,
enumerable: false
});
const keys = Object.getOwnPropertySymbols(obj);
console.log(keys.length);
console.log(keys[0] === visible, keys[1] === hidden);
console.log(keys.includes(inherited));
console.log(keys.map(key => obj[key]).join(','));Résultat
2 true true false 20,30
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.