Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

L’operatore instanceof

Se l’operando destro è una funzione ordinaria non vincolata, l’operatore instanceof verifica per impostazione predefinita se il suo `prototype` compare nella catena dei prototipi di un oggetto. Tiene conto dell’ereditarietà, ma non dimostra come è stato creato un oggetto né che siano presenti determinati campi.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

value instanceof Target

value instanceof Target restituisce un valore booleano oppure genera un’eccezione. Nel test predefinito, se value è un oggetto e Target è una funzione ordinaria non vincolata, l’operatore cerca l’oggetto Target.prototype nella catena dei prototipi di value, confrontando l’identità degli oggetti. Un’istanza di una classe derivata è quindi anche un’istanza della sua classe base. Se Target è una funzione vincolata (ad esempio, creata con bind), il meccanismo integrato ripete il test instanceof con la funzione sottostante anziché leggere Target.prototype. Per farlo non serve un metodo Symbol.hasInstance personalizzato. instanceof è una parola riservata.

Il test non esamina la proprietà constructor né la cronologia delle chiamate a new. Un oggetto creato con Object.create(Target.prototype) può superare il test senza che venga eseguito il costruttore. Modificare i prototipi può cambiare il risultato; realm separati, come i frame, possono avere oggetti prototipo diversi.

Target[Symbol.hasInstance] può personalizzare il test; il suo risultato viene convertito in un valore booleano. Senza una gestione personalizzata, i primitivi a sinistra producono false. Un primitivo a destra causa un TypeError; in assenza di un metodo adatto, il lato destro deve essere invocabile. Se il test predefinito degli oggetti legge Target.prototype e quel valore non è un oggetto, genera un TypeError.

Scrivi la negazione come !(value instanceof Target), non come !value instanceof Target: quest’ultima espressione verifica !value. Non considerare il risultato una prova che esistano campi o che i dati siano validi.

Esempi

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);

Risultato

true
true
true
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti