CKTIS / JavaScript
Object.hasOwn : tester une propriété propre
Object.hasOwn renvoie true si une clé est une propriété propre de l’objet, sans égard à sa valeur ni à son énumérabilité.
Version : ECMAScript 2022 onward; example target: Node.js 24.22.2
Syntaxe
Object.hasOwn(obj, prop)Object.hasOwn(obj, prop) applique d’abord ToObject(obj) puis convertit prop avec ToPropertyKey ; les clés chaîne et Symbol fonctionnent. Le booléen indique si le descripteur appartient directement à l’objet. Les propriétés héritées sont ignorées et une valeur undefined existante n’est pas confondue avec une absence.
Le test couvre propriétés de données et accesseurs, même non énumérables. Sur un objet ordinaire il ne lit pas la valeur et n’appelle aucun getter. Il est plus sûr que obj.hasOwnProperty(prop) pour un objet sans prototype ou qui masque hasOwnProperty. in et Reflect.has répondent autrement car ils parcourent la chaîne de prototypes.
La méthode existe depuis ECMAScript 2022. null et undefined lèvent TypeError ; les autres primitives sont encapsulées, donc l’indice 1 de "abc" peut être propre. La conversion de clé peut exécuter du code et lever. Pour un Proxy, le piège getOwnPropertyDescriptor s’exécute ; son exception ou une violation d’invariant peut produire TypeError.
Exemples
const token = Symbol("token");
const proto = { inherited: 1 };
const record = Object.create(proto);
Object.defineProperty(record, "hidden", { value: 2 });
record[token] = undefined;
console.log(Object.hasOwn(record, "hidden"), Object.hasOwn(record, "inherited"));
console.log(Object.hasOwn(record, token), Object.hasOwn(record, "missing"));
console.log(Object.hasOwn("abc", 1));
try { Object.hasOwn(null, "x"); } catch (error) { console.log(error.name); }Résultat
true false true false true TypeError
L’exemple distingue propriétés propres, héritées, Symbol, absentes et indice d’une chaîne encapsulée.