instanceof
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Please take two minutes to fill out our short survey.
instanceof
演算子は、あるコンストラクターの prototype
プロパティが、あるオブジェクトのプロトタイプチェーンの中のどこかに現れるかどうかを検査します。返値は論理値です。
試してみましょう
function Car(make, model, year) {
this.make = make;
this.model = model;
this.year = year;
}
const auto = new Car("Honda", "Accord", 1998);
console.log(auto instanceof Car);
// Expected output: true
console.log(auto instanceof Object);
// Expected output: true
構文
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
は false
を返します。 Array.prototype !== window.frames[0].Array.prototype
であり、配列は前者を継承しているからです。
これは、始めはわかりにくいかもしれませんが、スクリプトで複数のフレームやウィンドウを扱い、オブジェクトをあるコンテキストから別のコンテキストへ関数を経由して渡すようになると、正当かつ重要な事項になります。例えば、Array.isArray(myObj)
を使用すると、与えられたオブジェクトが実際に配列であるかどうかを安全にチェックできます。
例えば、別のコンテキストで Node が SVGElement であるかどうかをチェックするには、myNode instanceof myNode.ownerDocument.defaultView.SVGElement
を使用してください。
例
instanceof を String に対して使用
以下の例では、 instanceof
を String
オブジェクトに使用した場合の動作を示しています。
let literalString = "これは文字列リテラルです";
let stringObject = new String("コンストラクターで作成された String です");
literalString instanceof String; // false : 文字列リテラルは String ではない
stringObject instanceof String; // true
literalString instanceof Object; // false : 文字列リテラルは Object ではない
stringObject instanceof Object; // true
stringObject instanceof Date; // false
instanceof を Date に対して使用
以下の例では、 instanceof
を Date
オブジェクトに使用した場合の動作を示しています。
let myDate = new Date();
myDate instanceof Date; // true
myDate instanceof Object; // true
myDate instanceof String; // false
Object.create() で生成された Object
以下の例では、 instanceof
を Object.create()
で生成したオブジェクトに使用した場合の動作を示しています。
function Shape() {}
function Rectangle() {
Shape.call(this); // スーパークラスのコンストラクターを呼び出す。
}
Rectangle.prototype = Object.create(Shape.prototype);
Rectangle.prototype.constructor = Rectangle;
let rect = new Rectangle();
rect instanceof Object; // true
rect instanceof Shape; // true
rect instanceof Rectangle; // true
rect instanceof String; // false
let literalObject = {};
let nullObject = Object.create(null);
nullObject.name = "My object";
literalObject instanceof Object; // true : すべてのオブジェクトリテラルは Object.prototype をプロトタイプとして持つ
({}) instanceof Object; // true : 上記と同じ
nullObject instanceof Object; // false : プロトタイプはプロトタイプチェーンの末尾 (null)
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 の否定
あるオブジェクトが特定のコンストラクターの instanceof
でないことを検査するには、次のようにします。
if (!(mycar instanceof Car)) {
// 次のようなことをします。
// mycar = new Car(mycar)
}
これは実際には次のものとは異なります。
if (!mycar instanceof Car)
これは常に false
になります。(!mycar
は instanceof
の前に評価されるため、常に論理値が Car
のインスタンスであるかどうかを検査しようとします。)
仕様書
Specification |
---|
ECMAScript® 2026 Language Specification # sec-relational-operators |