CKTIS / JavaScript
Operator instanceof
Kad je desni operand obična, nevezana funkcija, operator instanceof prema zadanim postavkama provjerava pojavljuje li se njezin `prototype` u lancu prototipova objekta. Uzima u obzir nasljeđivanje, ali ne dokazuje kako je objekt stvoren ni postoje li određena polja.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
value instanceof Targetvalue instanceof Target vraća Booleovu vrijednost ili pokreće iznimku. U zadanom testu, ako je value objekt, a Target obična, nevezana funkcija, operator traži objekt Target.prototype u lancu prototipova vrijednosti value, uspoređujući pritom identitet objekata. Instanca izvedene klase zato je i instanca njezine osnovne klase. Ako je Target vezana funkcija (primjerice, stvorena pomoću bind), ugrađeni mehanizam ponavlja test instanceof s funkcijom na koju je Target vezana umjesto da čita Target.prototype. Za to nije potrebna prilagođena metoda Symbol.hasInstance. instanceof je rezervirana riječ.
Test ne pregledava svojstvo constructor ni povijest poziva new. Objekt stvoren pomoću Object.create(Target.prototype) može proći test bez izvršavanja konstruktora. Promjena prototipova može promijeniti rezultat; odvojeni realmi, primjerice okviri, mogu imati različite objekte prototipova.
Target[Symbol.hasInstance] može prilagoditi test; njegov se rezultat pretvara u Booleovu vrijednost. Bez prilagođene obrade primitivne vrijednosti s lijeve strane daju false. Primitivna vrijednost s desne strane uzrokuje TypeError; bez odgovarajuće metode desna strana mora biti pozivljiva. Ako zadani test objekta pročita Target.prototype, a ta vrijednost nije objekt, pokreće TypeError.
Negaciju zapiši kao !(value instanceof Target), a ne !value instanceof Target: potonji zapis testira !value. Rezultat nemoj smatrati dokazom da polja postoje ili da su podaci valjani.
Primjeri
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);Rezultat
true true true false
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.