Object.prototype.isPrototypeOf()

La méthode isPrototypeOf() permet de tester si un objet existe dans la chaîne de prototypes d'un autre objet.

Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et envoyez-nous une pull request.

Syntaxe

prototypeObj.isPrototypeOf(objet)

Paramètres

objet

L'objet dont la chaîne de prototypes sera parcourue.

Valeur de retour

Un Boolean indiquant si l'objet appelant se trouve dans sa chaîne de prototypes de l'objet indiqué.

Erreurs déclenchées

TypeError

Une exception TypeError est déclenchée si prototypeObj est undefined ou null.

Description

La méthode isPrototypeOf () vous permet de vérifier si un objet existe ou non dans la chaîne de prototypes d'un autre objet.

Exemples

Cet exemple montre que Bidule.prototype, Truc.prototype, Machin.prototype et Object.prototype font bien partie de la chaîne de prototype pour l'objet bidule :

function Machin() {}
function Truc() {}
function Bidule() {}

Truc.prototype = Object.create(Machin.prototype);
Bidule.prototype = Object.create(Truc.prototype);

var bidule = new Bidule();

console.log(Bidule.prototype.isPrototypeOf(bidule)); // true
console.log(Truc.prototype.isPrototypeOf(bidule)); // true
console.log(Machin.prototype.isPrototypeOf(bidule)); // true
console.log(Object.prototype.isPrototypeOf(bidule)); // true

La méthode isPrototypeOf(), avec l'opérateur instanceof en particulier, s'avère particulièrement utile si vous avez du code qui ne peut fonctionner que lorsqu'il traite des objets descendant d'une chaîne de prototypes donnée, par ex., pour garantir que certaines méthodes ou propriétés seront présentes dans cet objet.

Par exemple, vérifier que bidule descend bien de Machin.prototype :

if (Toto.prototype.isPrototypeOf(bidule)) {
  // effectuer quelque chose de sûr
}

Spécifications

Compatibilité des navigateurs

Voir aussi

• instanceof
• Object.getPrototypeOf()
• Object.setPrototypeOf()
• Object.prototype.__proto__