Function.prototype[Symbol.hasInstance]()

value

Das zu testende Objekt. Primitive Werte geben immer false zurück.

true, wenn sich func.prototype in der Prototypkette von value befindet; andernfalls false. Gibt immer false zurück, wenn value kein Objekt ist oder this keine Funktion ist. Wenn this eine gebundene Funktion ist, wird das Ergebnis eines instanceof-Tests für value und die zugrunde liegende Zielfunktion zurückgegeben.

TypeError

Wird ausgelöst, wenn this keine gebundene Funktion ist und this.prototype kein Objekt ist.

Der instanceof-Operator ruft die Methode [Symbol.hasInstance]() der rechten Seite auf, wann immer solch eine Methode existiert. Da alle Funktionen standardmäßig von Function.prototype erben, haben sie alle die [Symbol.hasInstance]()-Methode. Daher legt die Methode Function.prototype[Symbol.hasInstance]() meistens das Verhalten von instanceof fest, wenn die rechte Seite eine Funktion ist. Diese Methode implementiert das Standardverhalten des instanceof-Operators (den selben Algorithmus, wenn der Konstruktor keine [Symbol.hasInstance]()-Methode enthält).

Anders als die meisten Methoden ist die Eigenschaft Function.prototype[Symbol.hasInstance]() nicht konfigurierbar und nicht schreibbar. Dies ist eine Sicherheitsmaßnahme, um zu verhindern, dass die zugrunde liegende Zielfunktion einer gebundenen Funktion erlangt wird. Siehe diese Antwort auf Stack Overflow für ein Beispiel.

Sie würden selten diese Methode direkt aufrufen. Stattdessen wird diese Methode vom instanceof-Operator aufgerufen. Sie sollten erwarten, dass die beiden Ergebnisse normalerweise gleichwertig sind.

class Foo {}
const foo = new Foo();
console.log(foo instanceof Foo === Foo[Symbol.hasInstance](foo)); // true

Sie möchten diese Methode verwenden, wenn Sie das Standardverhalten von instanceof aufrufen möchten, aber nicht wissen, ob ein Konstruktor eine überschrieene [Symbol.hasInstance]()-Methode hat.

class Foo {
  static [Symbol.hasInstance](value) {
    // A custom implementation
    return false;
  }
}

const foo = new Foo();
console.log(foo instanceof Foo); // false
console.log(Function.prototype[Symbol.hasInstance].call(Foo, foo)); // true

• instanceof
• Symbol.hasInstance