Symbol.hasInstance

Статическое свойство данных Symbol.hasInstance представляет собой общеизвестный символ Symbol.hasInstance. Оператор instanceof ищет этот символ в своем правом операнде для метода, используемого для определения того, распознает ли конструктор объект как свой экземпляр.

Попробуйте

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

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

Значение

Общеизвестный символ Symbol.hasInstance.

Описание

Оператор instanceof использует следующий алгоритм для вычисления возвращаемого значения object instanceof constructor:

1. Если у constructor есть метод [Symbol.hasInstance](), то вызовите его с object в качестве первого аргумента и верните результат, приведенный к булеву типу. Выбросьте TypeError, если constructor не является объектом, или если constructor[Symbol.hasInstance] не является одним из null, undefined или функцией.
2. В противном случае, если у constructor нет метода [Symbol.hasInstance]() (constructor[Symbol.hasInstance] равен null или undefined), то определите результат, используя тот же алгоритм, что и для Function.prototype[Symbol.hasInstance](). Выбросьте TypeError, если constructor не является функцией.

Поскольку все функции по умолчанию наследуются от Function.prototype, в большинстве случаев метод Function.prototype[Symbol.hasInstance]() определяет поведение instanceof, когда правая часть является функцией.

Примеры

Пользовательское поведение instanceof

Вы можете реализовать свое пользовательское поведение instanceof следующим образом, например:

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

Проверка экземпляра объекта

Точно так же, как вы можете проверить, является ли объект экземпляром класса, используя ключевое слово instanceof, мы также можем использовать Symbol.hasInstance для таких проверок.

class Animal {
  constructor() {}
}

const cat = new Animal();

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

Спецификации

Совместимость с браузерами

См. также

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