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.

prototypeObj.isPrototypeOf(objet)

objet

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

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

TypeError

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

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.

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
}

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