CKTIS / JavaScript
Operátor instanceof
Ak je vpravo bežná neviazaná funkcia, operátor instanceof v predvolenom nastavení kontroluje, či sa jej `prototype` nachádza v reťazci prototypov objektu. Zohľadňuje dedenie, ale nedokazuje, ako bol objekt vytvorený ani či obsahuje určité položky.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
value instanceof Targetvalue instanceof Target vracia booleovskú hodnotu alebo vyvolá výnimku. Ak je value objekt a Target bežná neviazaná funkcia, predvolený test hľadá objekt Target.prototype v reťazci prototypov hodnoty value a porovnáva pritom identitu objektov. Inštancia odvodenej triedy je teda aj inštanciou jej základnej triedy. Ak je Target viazaná funkcia (napríklad vytvorená pomocou bind), vstavaný mechanizmus zopakuje test instanceof s funkciou, na ktorú je Target viazaná, namiesto čítania Target.prototype. Na to nie je potrebná vlastná metóda Symbol.hasInstance. instanceof je rezervované slovo.
Test neskúma vlastnosť constructor ani históriu volaní new. Objekt vytvorený pomocou Object.create(Target.prototype) môže testom prejsť bez spustenia konštruktora. Zmena prototypov môže zmeniť výsledok; oddelené realmy, napríklad rámce, môžu mať rôzne objekty prototypov.
Target[Symbol.hasInstance] môže test prispôsobiť; jeho výsledok sa prevedie na booleovskú hodnotu. Bez vlastného spracovania vedú primitívne hodnoty vľavo k výsledku false. Primitívna hodnota vpravo spôsobí TypeError; bez vhodnej metódy musí byť pravá strana volateľná. Ak predvolený test objektu prečíta Target.prototype a táto hodnota nie je objekt, vyvolá TypeError.
Záporný test zapisuj ako !(value instanceof Target), nie !value instanceof Target: druhý zápis testuje !value. Nepovažuj výsledok za dôkaz, že existujú položky alebo že sú údaje platné.
Prí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ýsledok
true true true false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.