CKTIS / JavaScript
De instanceof-operator
Met een gewone, ongebonden functie aan de rechterkant controleert de instanceof-operator standaard of de `prototype` van die functie voorkomt in de prototypeketen van een object. De operator houdt rekening met overerving, maar bewijst niet hoe een object is gemaakt of dat bepaalde velden bestaan.
Versie: 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 retourneert een Booleaanse waarde of veroorzaakt een uitzondering. Als value een object is en Target een gewone, ongebonden functie is, zoekt de operator bij de standaardtest in de prototypeketen van value naar het object Target.prototype en vergelijkt daarbij de objectidentiteit. Een instantie van een afgeleide klasse is dus ook een instantie van de basisklasse. Als Target een gebonden functie is (bijvoorbeeld gemaakt met bind), herhaalt het ingebouwde mechanisme de instanceof-test met de onderliggende functie in plaats van Target.prototype te lezen. Daarvoor is geen aangepaste Symbol.hasInstance-methode nodig. instanceof is een gereserveerd woord.
De test controleert niet de eigenschap constructor of de geschiedenis van aanroepen met new. Een object dat met Object.create(Target.prototype) is gemaakt, kan slagen zonder dat de constructor wordt uitgevoerd. Het wijzigen van prototypes kan de uitkomst veranderen; afzonderlijke realms, zoals frames, kunnen verschillende prototypeobjecten hebben.
Target[Symbol.hasInstance] kan de test aanpassen; de uitkomst ervan wordt omgezet in een Booleaanse waarde. Zonder aangepaste afhandeling leveren primitieve waarden aan de linkerkant false op. Een primitieve waarde aan de rechterkant veroorzaakt een TypeError; zonder een geschikte methode moet de rechterkant aanroepbaar zijn. Als de standaardtest voor objecten Target.prototype leest en die waarde geen object is, veroorzaakt de test een TypeError.
Schrijf de ontkenning als !(value instanceof Target), niet als !value instanceof Target: die laatste uitdrukking test !value. Beschouw de uitkomst niet als bewijs dat velden bestaan of gegevens geldig zijn.
Voorbeelden
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);Resultaat
true true true false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.