Object.prototype.isPrototypeOf()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Exemple interactif

Note : isPrototypeOf() est différent de l'opérateur instanceof. Dans l'expression "object instanceof AFunction", on compare la chaîne de prototypes d'object avec AFunction.prototype et non avec AFunction.

Syntaxe

js
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 :

js
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 :

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

Spécifications

Specification
ECMAScript Language Specification
# sec-object.prototype.isprototypeof

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi