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

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.

Sources