WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Der instanceof-Operator

Steht rechts eine gewöhnliche, ungebundene Funktion, prüft der instanceof-Operator standardmäßig, ob ihr `prototype` in der Prototypkette eines Objekts vorkommt. Er berücksichtigt Vererbung, beweist aber weder, wie ein Objekt erstellt wurde, noch, dass bestimmte Felder vorhanden sind.

Version: 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 Target

value instanceof Target gibt einen booleschen Wert zurück oder löst eine Ausnahme aus. Ist value ein Objekt und Target eine gewöhnliche, ungebundene Funktion, sucht der Operator beim Standardtest in der Prototypkette von value nach dem Objekt Target.prototype und vergleicht dabei die Objektidentität. Eine Instanz einer abgeleiteten Klasse ist daher auch eine Instanz ihrer Basisklasse. Ist Target eine gebundene Funktion (etwa eine mit bind erzeugte Funktion), wiederholt der eingebaute Mechanismus den instanceof-Test mit der zugrunde liegenden Funktion, statt Target.prototype zu lesen. Dazu ist keine benutzerdefinierte Methode Symbol.hasInstance nötig. instanceof ist ein reserviertes Wort.

Der Test untersucht weder die Eigenschaft constructor noch, ob zuvor new aufgerufen wurde. Ein mit Object.create(Target.prototype) erstelltes Objekt kann den Test bestehen, ohne dass der Konstruktor ausgeführt wird. Änderungen an Prototypen können das Ergebnis verändern; getrennte Realms, etwa Frames, können unterschiedliche Prototypobjekte haben.

Target[Symbol.hasInstance] kann den Test anpassen; sein Ergebnis wird in einen booleschen Wert umgewandelt. Ohne eine solche benutzerdefinierte Behandlung ergibt ein primitiver Wert auf der linken Seite false. Ein primitiver Wert auf der rechten Seite verursacht einen TypeError; ohne eine geeignete Methode muss die rechte Seite aufrufbar sein. Liest der standardmäßige Objekttest Target.prototype und ist dieser Wert kein Objekt, löst er einen TypeError aus.

Schreibe die Negation als !(value instanceof Target), nicht als !value instanceof Target: Letzteres prüft !value. Betrachte das Ergebnis nicht als Beweis dafür, dass Felder vorhanden oder Daten gültig sind.

Beispiele

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);

Ergebnis

true
true
true
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen