Object : méthode isPrototypeOf()

Exemple interactif

function Toto() {}
function Truc() {}

Truc.prototype = Object.create(Toto.prototype);

const truc = new Truc();

console.log(Toto.prototype.isPrototypeOf(truc));
// Résultat attendu : true
console.log(Truc.prototype.isPrototypeOf(truc));
// Résultat attendu : true

Syntaxe

isPrototypeOf(object)

Paramètres

objet

L'objet dont la chaîne de prototypes doit être parcourue.

Valeur de retour

Un booléen indiquant si l'objet appelant (this) se trouve dans la chaîne de prototypes de object. Retourne directement false lorsque object n'est pas un objet (c'est-à-dire un primitif).

Erreurs déclenchées

TypeError

Levé si this est null ou undefined (car il ne peut pas être converti en objet).

Description

Tous les objets qui héritent de Object.prototype (c'est-à-dire tous sauf les objets avec prototype null) héritent de la méthode isPrototypeOf(). Cette méthode permet de vérifier si un objet existe ou non dans la chaîne de prototypes d'un autre objet. Si l'argument object n'est pas un objet (c'est-à-dire un primitif), la méthode retourne directement false. Sinon, la valeur de this est convertie en objet, et la chaîne de prototypes de object est parcourue à la recherche de la valeur de this, jusqu'à ce que la fin de la chaîne soit atteinte ou que la valeur de this soit trouvée.

Exemples

Utiliser la méthode isPrototypeOf()

Cet exemple démontre que Machin.prototype, Truc.prototype, Toto.prototype et Object.prototype existent dans la chaîne de prototypes pour l'objet machin :

class Toto {}
class Truc extends Toto {}
class Machin extends Truc {}

const toto = new Toto();
const truc = new Truc();
const machin = new Machin();

// chaîne de prototypes :
// toto : Toto --> Object
// truc : Truc --> Toto --> Object
// machin : Machin --> Truc --> Toto --> Object
console.log(Machin.prototype.isPrototypeOf(machin)); // true
console.log(Machin.prototype.isPrototypeOf(truc)); // false
console.log(Machin.prototype.isPrototypeOf(toto)); // false
console.log(Truc.prototype.isPrototypeOf(machin)); // true
console.log(Truc.prototype.isPrototypeOf(toto)); // false
console.log(Toto.prototype.isPrototypeOf(machin)); // true
console.log(Toto.prototype.isPrototypeOf(truc)); // true
console.log(Object.prototype.isPrototypeOf(machin)); // true

La méthode isPrototypeOf() — ainsi que l'opérateur instanceof — est particulièrement utile si vous avez du code qui ne peut fonctionner qu'avec des objets descendants d'une chaîne de prototypes spécifique ; par exemple, pour garantir que certaines méthodes ou propriétés sont présentes sur cet objet.

Par exemple, pour exécuter un code qui n'est sûr à exécuter que si un objet machin a Toto.prototype dans sa chaîne de prototypes, vous pouvez faire ceci :

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

Cependant, le fait que Toto.prototype existe dans la chaîne de prototypes de machin n'implique pas que machin a été créé en utilisant Toto comme constructeur. Par exemple, machin peut être directement assigné avec Toto.prototype comme prototype. Dans ce cas, si votre code lit les champs privés de Toto à partir de machin, cela échoue toujours :

class Toto {
  #value = "toto";
  static getValue(x) {
    return x.#value;
  }
}

const machin = { __proto__: Toto.prototype };

if (Toto.prototype.isPrototypeOf(machin)) {
  console.log(Toto.getValue(machin)); // TypeError: Ne peut pas lire le membre privé #value d'un objet dont la classe ne l'a pas déclaré
}

Il en va de même pour instanceof. Si vous avez besoin de lire des champs privés de manière sécurisée, proposez plutôt une méthode de vérification marquée en utilisant in.

class Toto {
  #value = "toto";
  static getValue(x) {
    return x.#value;
  }
  static estToto(x) {
    return #value in x;
  }
}

const machin = { __proto__: Toto.prototype };

if (Toto.estToto(machin)) {
  // Ne s'exécute pas, car machin n'est pas un Toto
  console.log(Toto.getValue(machin));
}

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'opérateur instanceof
• La méthode statique Object.getPrototypeOf()
• La méthode statique Object.setPrototypeOf()
• Héritage et chaîne de prototypes