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

CKTIS / JavaScript

Object.prototype.hasOwnProperty() — vérifier les propriétés propres

Object.prototype.hasOwnProperty() vérifie si une propriété appartient directement à un objet plutôt qu’à son prototype. Découvrez sa différence avec `in` et comment l’appeler de façon sûre lorsque la méthode est masquée.

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

obj.hasOwnProperty(prop)
Object.prototype.hasOwnProperty.call(obj, prop)

Object.prototype.hasOwnProperty renvoie true si l’objet possède la propriété propre indiquée, et false si la propriété est héritée ou absente. L’argument prop peut être un nom de chaîne ou un symbole. Une valeur null ou undefined ne signifie pas que la propriété est absente.

La méthode prend en compte les propriétés énumérables et non énumérables. L’opérateur in vérifie aussi la chaîne de prototypes ; il peut donc renvoyer true alors que hasOwnProperty() renvoie false.

L’appel obj.hasOwnProperty(prop) n’est pas fiable si l’objet masque cette méthode, et un objet créé avec Object.create(null) ne l’hérite pas du tout. Utilisez Object.prototype.hasOwnProperty.call(obj, prop) pour éviter ces deux problèmes. Dans du nouveau code, préférez Object.hasOwn(obj, prop) si l’environnement cible le prend en charge.

Exemples

const obj = Object.create({ inherited: 1 });
obj.own = undefined;
obj.hasOwnProperty = false;

console.log(Object.prototype.hasOwnProperty.call(obj, "own"));
console.log(Object.prototype.hasOwnProperty.call(obj, "inherited"));
console.log("inherited" in obj);
console.log(Object.prototype.hasOwnProperty.call(obj, "missing"));

Résultat

true
false
true
false

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