Function.prototype[@@hasInstance]()

구문

func[Symbol.hasInstance](value)

매개변수

• value
  • :평가할 객체입니다. 원시 값은 항상 false를 반환합니다.

반환 값

func.prototype이 value의 프로토타입 체인에 있으면 true, 그렇지 않으면 false를 반환합니다. value가 객체가 아니거나 this가 함수가 아닌 경우 항상 false를 반환합니다. this가 바인딩된 함수인 경우, value와 대상 함수에 대한 instanceof 평가 결과를 반환합니다.

예외

TypeError

this가 바인딩된 함수가 아니고 this.prototype이 객체가 아닌 경우 발생합니다.

설명

instanceof 연산자는 [@@hasInstance]() 메서드가 존재하면 우항의 이 메서드를 호출합니다. 모든 함수는 기본적으로 Function.prototype을 상속하므로 [@@hasInstance]() 메서드를 모두 가지게 됩니다. 따라서 대부분의 경우 우항이 함수인 경우 Function.prototype[@@hasInstance] 메서드가 instanceof의 동작을 지정합니다. 이 메서드는 instanceof 연산자의 기본 동작을 구현합니다(constructor에 @@hasInstance 메서드가 없을 때와 동일한 알고리즘).

대부분의 메서드와 달리 Function.prototype[@@hasInstance]() 속성은 설정할 수 없고 쓸 수 없습니다. 이는 바인딩된 함수의 기본 대상 함수를 가져올 수 없도록 하기 위한 보안 기능입니다. 예를 들어 이 StackOverflow 답변을 참고하시기 바랍니다.

예제

기본 instanceof 동작으로 되돌리기

이 메서드를 직접 호출할 필요는 거의 없습니다. 대신 이 메서드는 instanceof 연산자가 호출합니다. 일반적으로 두 결과는 동일할 것으로 예상해야 합니다.

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

기본적인 instanceof 동작을 호출하고 싶지만 생성자에 재정의된 [@@hasInstance]() 메서드가 있는지 알 수 없는 경우 이 메서드를 사용할 수 있습니다.

class Foo {
  static [Symbol.hasInstance](value) {
    // 맞춤 구현
    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