instanceof

instanceof 演算子は、オブジェクトが自身のプロトタイプにコンストラクタの prototype プロパティを持っているかを確認します。戻り値はブール値です。

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

構文

object instanceof constructor

引数

object

確認するオブジェクト

constructor

オブジェクトに対して確認を行う関数

説明

instanceof 演算子は、object のプロトタイプチェインで constructor.prototype の存在を確認します。

// コンストラクタを定義
function C() {}
function D() {}

let o = new C()

// true なぜなら: Object.getPrototypeOf(o) === C.prototype
o instanceof C;

// false D.prototype は o のプロトタイプチェーンのどこにも存在しない
o instanceof D;

o instanceof Object;          // true なぜなら...
C.prototype instanceof Object // true だから

C.prototype = {} 
let o2 = new C() 

o2 instanceof C; // true

// false C.prototype は o のプロトタイプチェーンの
// どこにも存在しない
o instanceof C; 

D.prototype = new C(); // 継承を使用
let o3 = new D()
o3 instanceof D; // true
o3 instanceof C; // true o3 のプロトタイプチェーンに C.prototype があるため。

注意事項: instanceof による確認結果はコンストラクタの prototype プロパティの変化に従って変わることがあります。また、オブジェクトのプロトタイプを Object.setPrototypeOf を用いて変更した場合や、非標準の __proto__ 疑似プロパティを用いた場合も変わりえます。

instanceof と複数のコンテキスト (例: frame や window)

異なるスコープは、別々の実行環境を持ちます。つまり、それらは別々の組み込み物 (別々のグローバルオブジェクト、別々のコンストラクタ 等々) を持ちます。これにより予期せぬ結果になる場合があります。例えば、[] instanceof window.frames[0].Array は、Array.prototype !== window.frames[0].Array であることおよび配列が以前から継承していることから false を返します。

これは、始めはわかりにくいかもしれませんが、スクリプトで複数のフレームやウィンドウを扱い始め、オブジェクトをあるコンテキストから別のコンテキストへ関数を経由して渡すようになると、正当かつ重要な事項になります。例えば、Array.isArray(myObj) を使用して、与えられたオブジェクトが実際に配列であるかどうかを安全にチェックできます。

例えば、別のコンテキストで Nodes が SVGElement であるかどうかをチェックするには、myNode instanceof myNode.ownerDocument.defaultView.SVGElement を使用します。

例

String や Date が Object タイプであることの実証

以下のコードは、String や Date オブジェクトが Object タイプでもある (Object から派生している) ことの実証に instanceof を用いています。

また、オブジェクトリテラルを用いて作成されたオブジェクトに対する例外、つまり、prototype が undefined であるにも関わらず instanceof Object が true を報告する例を示します。

let simpleStr = 'This is a simple string'
let myString  = new String()
let newStr    = new String('コンストラクターで作成された文字列')
let myDate    = new Date()
let myObj     = {}
let myNonObj  = Object.create(null)

simpleStr instanceof String  // false を返す 文字列リテラルはオブジェクトではありません。
myString  instanceof String  // true を返す
newStr    instanceof String  // true を返す
myString  instanceof Object  // true を返す

myObj    instanceof Object   // true を返す すべてのオブジェクトリテラルはプロトタイプとして Object.prototype を持っています。
({})     instanceof Object   // true を返す 上記と同じ
myNonObj instanceof Object   // false を返す プロトタイプはプロトタイプチェーンの終わりです（null）
myString instanceof Date     // false を返す

myDate instanceof Date      // true を返す
myDate instanceof Object    // true を返す
myDate instanceof String    // false を返す

mycar が Car タイプおよび Object タイプであることの実証

以下のコードは、Car オブジェクトタイプとそのインスタンスである mycar を生成しています。instanceof 演算子で、mycar は Car タイプおよび Object タイプであることを実証します。

function Car(make, model, year) {
  this.make = make;
  this.model = model;
  this.year = year;
}
let mycar = new Car('Honda', 'Accord', 1998) 
let a = mycar instanceof Car     // true を返す
let b = mycar instanceof Object  // true を返す

インスタンスではないことの実証

オブジェクトが特定のコンストラクタの instanceof でないかどうかを確認するには次のようにします。

if (!(mycar instanceof Car)) {
  // Do something, like:
  // mycar = new Car(mycar)
}

これは実際には次のものとは異なります。

if (!mycar instanceof Car)

これは常に false になります。(!mycar は instanceof の前に評価され、常に Car のインスタンスを確認したブール値になります)。

仕様

ブラウザー実装状況

関連情報

• typeof
• Symbol.hasInstance
• Object.prototype.isPrototypeOf