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 Targetvalue 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.