Symbol.hasInstance は静的データプロパティで、ウェルノウンシンボルのSymbol.hasInstance を表します。instanceof 演算子は右辺オペランドに対して、コンストラクターオブジェクトがオブジェクトをそのインスタンスとして認識するかどうかを判断する際に使用されるメソッドを、このシンボルで探します。

試してみましょう

class Array1 {  static [Symbol.hasInstance](instance) {    return Array.isArray(instance);  }}console.log([] instanceof Array1);// 予想される結果: true

値

ウェルノウンシンボルSymbol.hasInstance です。

解説

instanceof 演算子は、object instanceof constructor の返値を計算するために以下のアルゴリズムを使用します。

1. constructor に[Symbol.hasInstance]() メソッドがあった場合、object を最初のオブジェクトとして呼び出し、結果を論理値に変換して返します。constructor がオブジェクトでない場合、またはconstructor[Symbol.hasInstance] がnull、undefined、関数のいずれでもでない場合、TypeError が発生します。
2. それ以外の場合、constructor に[Symbol.hasInstance]() メソッドがない場合（constructor[Symbol.hasInstance] がnull またはundefined）、Function.prototype[Symbol.hasInstance]() と同じアルゴリズムを使用して結果を決定します。constructor が関数でない場合、TypeError が発生します。

Because all functions inherit fromFunction.prototype by default, most of the time, theFunction.prototype[Symbol.hasInstance]() method specifies the behavior ofinstanceof when the right-hand side is a function.

例

独自のインスタンスでの動作

たとえば、次のようにして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]()