Function.prototype[Symbol.hasInstance]()

Метод [Symbol.hasInstance]() экземпляров Function определяет процедуру по умолчанию для определения того, распознаёт ли функция-конструктор объект как один из экземпляров конструктора. Он вызывается оператором instanceof.

Синтаксис

func[Symbol.hasInstance](value)

Параметры

value

Объект для проверки. Примитивные значения всегда возвращают false.

Возвращаемое значение

true, если func.prototype находится в цепочке прототипов value; в противном случае — false. Всегда возвращает false, если value не является объектом или this не является функцией. Если this является связанной функцией, возвращает результат проверки instanceof для value и нижележащей целевой функции.

Исключения

TypeError

Выбрасывается, если this не является связанной функцией и this.prototype не является объектом.

Описание

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

В отличие от большинства методов, свойство Function.prototype[Symbol.hasInstance]() не является конфигурируемым и не является записываемым. Это функция безопасности, предотвращающая получение нижележащей целевой функции связанной функции. См. этот ответ Stack Overflow для примера.

Примеры

Возврат к поведению instanceof по умолчанию

Вам редко потребуется вызывать этот метод напрямую. Вместо этого, этот метод вызывается оператором instanceof. Вы должны ожидать, что эти два результата обычно будут эквивалентны.

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

Вы можете захотеть использовать этот метод, если хотите вызвать поведение instanceof по умолчанию, но не знаете, имеет ли конструктор переопределенный метод [Symbol.hasInstance]().

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