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

CKTIS / JavaScript

L’opérateur instanceof

Si l’opérande de droite est une fonction ordinaire non liée, l’opérateur instanceof vérifie par défaut si son `prototype` figure dans la chaîne de prototypes d’un objet. Il tient compte de l’héritage, mais ne prouve ni comment l’objet a été créé ni que certains champs existent.

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

value instanceof Target

value instanceof Target renvoie une valeur booléenne ou déclenche une exception. Dans le test par défaut, si value est un objet et Target une fonction ordinaire non liée, l’opérateur recherche l’objet Target.prototype dans la chaîne de prototypes de value, en comparant l’identité des objets. Une instance d’une classe dérivée est donc également une instance de sa classe de base. Si Target est une fonction liée (par exemple, créée avec bind), le mécanisme intégré répète le test instanceof avec la fonction sous-jacente au lieu de lire Target.prototype. Ce mécanisme ne nécessite aucune méthode Symbol.hasInstance personnalisée. instanceof est un mot réservé.

Le test n’examine ni la propriété constructor ni l’historique des appels à new. Un objet créé avec Object.create(Target.prototype) peut réussir le test sans que le constructeur soit exécuté. Modifier les prototypes peut changer le résultat ; des realms distincts, comme des frames, peuvent avoir des objets prototypes différents.

Target[Symbol.hasInstance] peut personnaliser le test ; son résultat est converti en valeur booléenne. Sans traitement personnalisé, une valeur primitive à gauche donne false. Une valeur primitive à droite provoque une TypeError ; en l’absence de méthode appropriée, l’expression à droite doit être appelable. Si le test d’objet par défaut lit Target.prototype et que cette valeur n’est pas un objet, il déclenche une TypeError.

Écris la négation sous la forme !(value instanceof Target), et non !value instanceof Target : cette dernière expression teste !value. Ne considère pas le résultat comme une preuve que des champs existent ou que les données sont valides.

Exemples

class Animal {}
class Dog extends Animal {}

const dog = new Dog();
const linked = Object.create(Dog.prototype);

console.log(dog instanceof Dog);
console.log(dog instanceof Animal);
console.log(linked instanceof Dog);
console.log("dog" instanceof String);

Résultat

true
true
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