CKTIS / JavaScript
Operátor instanceof
Je-li vpravo běžná nevázaná funkce, operátor instanceof ve výchozím nastavení kontroluje, zda se její `prototype` nachází v řetězci prototypů objektu. Zohledňuje dědičnost, ale nedokazuje, jak byl objekt vytvořen ani zda obsahuje určité položky.
Verze: 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 Targetvalue instanceof Target vrací booleovskou hodnotu, nebo vyvolá výjimku. Pokud je value objekt a Target běžná nevázaná funkce, výchozí test hledá objekt Target.prototype v řetězci prototypů hodnoty value a porovnává přitom identitu objektů. Instance odvozené třídy je tedy také instancí její základní třídy. Je-li Target vázaná funkce (například vytvořená pomocí bind), vestavěný mechanismus zopakuje test instanceof s funkcí, na kterou je Target vázána, místo aby četl Target.prototype. K tomu není potřeba vlastní metoda Symbol.hasInstance. instanceof je rezervované slovo.
Test nezkoumá vlastnost constructor ani historii volání new. Objekt vytvořený pomocí Object.create(Target.prototype) může testem projít, aniž by se spustil konstruktor. Změna prototypů může změnit výsledek; oddělené realmy, například rámce, mohou mít různé objekty prototypů.
Target[Symbol.hasInstance] může test přizpůsobit; jeho výsledek se převede na booleovskou hodnotu. Bez vlastního zpracování vedou primitivní hodnoty vlevo k výsledku false. Primitivní hodnota vpravo způsobí TypeError; bez vhodné metody musí být pravá strana volatelná. Pokud výchozí test objektu přečte Target.prototype a tato hodnota není objekt, vyvolá TypeError.
Záporný test zapisuj jako !(value instanceof Target), nikoli !value instanceof Target: druhý zápis testuje !value. Nepovažuj výsledek za důkaz, že existují položky nebo že jsou data platná.
Příklady
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);Výsledek
true true true false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.