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 bekannte Symbol Symbol.hasInstance.

Beschreibung

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

1. Wenn constructor eine [Symbol.hasInstance]()-Methode hat, dann rufen Sie diese mit object als erstem Argument auf und geben das Ergebnis zurück, umgewandelt in einen Boolean. Werfen Sie einen TypeError, 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), dann bestimmen Sie das Ergebnis mit dem gleichen Algorithmus wie Function.prototype[Symbol.hasInstance](). Werfen Sie einen TypeError, wenn constructor keine Funktion ist.

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

Beispiele

Benutzerdefiniertes instanceof-Verhalten

Sie können Ihr benutzerdefiniertes instanceof-Verhalten so implementieren, zum Beispiel:

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üfung der Instanz eines Objekts

Genau wie Sie überprüfen können, ob ein Objekt eine Instanz einer Klasse ist, indem Sie das instanceof-Schlüsselwort verwenden, 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]()