Symbol.hasInstance

Probieren Sie es aus

class Array1 {
  static [Symbol.hasInstance](instance) {
    return Array.isArray(instance);
  }
}

console.log([] instanceof Array1);
// Expected output: true

Wert

Das wohlbekannte Symbol Symbol.hasInstance.

Beschreibung

Der instanceof Operator verwendet den folgenden Algorithmus, um den Rückgabewert von object instanceof constructor zu berechnen:

1. Falls constructor eine [Symbol.hasInstance]() Methode hat, wird diese mit object als erstem Argument aufgerufen und das Ergebnis zurückgegeben, zu einem Boolean umgewandelt. Ein TypeError wird ausgelöst, wenn constructor kein Objekt ist oder wenn constructor[Symbol.hasInstance] weder null, undefined noch eine Funktion ist.
2. Andernfalls, wenn constructor keine [Symbol.hasInstance]() Methode hat (constructor[Symbol.hasInstance] ist null oder undefined), wird das Ergebnis unter Verwendung des gleichen Algorithmus wie bei Function.prototype[Symbol.hasInstance]() bestimmt. Ein TypeError wird ausgelöst, wenn constructor keine Funktion ist.

Da alle Funktionen standardmäßig von Function.prototype erben, legt in den meisten Fällen die Methode Function.prototype[Symbol.hasInstance]() das Verhalten von instanceof fest, wenn die rechte Seite eine Funktion ist.

Beispiele

Benutzerdefiniertes instanceof Verhalten

Sie könnten Ihr benutzerdefiniertes instanceof Verhalten wie folgt implementieren:

class MyArray {
  static [Symbol.hasInstance](instance) {
    return Array.isArray(instance);
  }
}
console.log([] instanceof MyArray); // true

function MyArray() {}
Object.defineProperty(MyArray, Symbol.hasInstance, {
  value(instance) {
    return Array.isArray(instance);
  },
});
console.log([] instanceof MyArray); // true

Überprüfen der Instanz eines Objekts

Genauso wie Sie überprüfen können, ob ein Objekt eine Instanz einer Klasse mit dem Schlüsselwort instanceof ist, können wir auch Symbol.hasInstance für solche Überprüfungen verwenden.

class Animal {
  constructor() {}
}

const cat = new Animal();

console.log(Animal[Symbol.hasInstance](cat)); // true

Spezifikationen

Browser-Kompatibilität

Siehe auch

• instanceof
• Function.prototype[Symbol.hasInstance]()