JavaScript instanceof エラー対策！Array.isArray() とカスタム型ガード関数の使い方

2025-04-26

instanceof演算子の基本的な使い方

instanceof演算子は、オブジェクトが特定のコンストラクタ関数によって生成されたインスタンスかどうかを判定するために使用します。

object instanceof Constructor

Constructor: コンストラクタ関数
object: チェックしたいオブジェクト

エラーが発生する状況

「Errors: invalid right-hand side instanceof operand」エラーは、Constructorの部分が以下のいずれかの状況になっている場合に発生します。

プリミティブ値（primitive value）
- 文字列、数値、真偽値、シンボル、null、undefinedなどのプリミティブ値が指定された場合。
- 例：object instanceof "string" (文字列はコンストラクタではありません)
オブジェクトでない値
- 関数オブジェクト以外のオブジェクトが右辺にきた場合。
関数でない値
- コンストラクタとして機能する関数が右辺にきていない場合。
Symbol.hasInstanceメソッドがないオブジェクト
- instanceof演算子の右辺のオブジェクトが、Symbol.hasInstanceメソッドを実装していない場合。

具体的な例

let myString = "hello";
let myNumber = 123;
let myArray = [1, 2, 3];

console.log(myString instanceof String); // 正しい
console.log(myNumber instanceof Number); // 正しい
console.log(myArray instanceof Array); // 正しい

console.log(myString instanceof "string"); // エラー: invalid right-hand side instanceof operand
console.log(myNumber instanceof 123); // エラー: invalid right-hand side instanceof operand
console.log(myArray instanceof {}); // エラー: invalid right-hand side instanceof operand

let obj = {};
console.log(myArray instanceof obj); //エラー invalid right-hand side instanceof operand

オブジェクトの型チェックをする場合は、constructorプロパティを使用することもできます。
プリミティブ値の型をチェックする場合は、typeof演算子を使用してください。
instanceof演算子の右辺には、常にコンストラクタ関数を指定するようにしてください。

よくあるエラーパターン

プリミティブ値の誤用
- instanceofの右辺に文字列、数値、真偽値などのプリミティブ値を指定してしまうケースです。
  - 例: object instanceof "String"、object instanceof 123
  - 解決策: typeof演算子を使用するか、ラッパーオブジェクト(new String(), new Number())を使用します。
オブジェクトリテラルの誤用
- instanceofの右辺に空のオブジェクトリテラル({})や、コンストラクタでないオブジェクトを指定してしまうケースです。
  - 例: object instanceof {}、object instanceof myObject (myObjectがコンストラクタでない場合)
  - 解決策: コンストラクタ関数またはクラスを使用します。
変数のスコープの問題
- instanceofの右辺に指定したコンストラクタ関数が、期待されるスコープに存在しないケースです。
  - 例: クロージャ内で定義されたコンストラクタ関数が、外部スコープから参照できない場合。
  - 解決策: スコープを確認し、コンストラクタ関数が正しいスコープから参照できるようにします。
モジュールシステムの誤用
- ES ModulesやCommonJSなどのモジュールシステムを使用している場合、モジュール間のコンストラクタ関数の参照が正しく行われていないケースがあります。
  - 例: 異なるモジュールで定義されたコンストラクタ関数をinstanceofで使用する場合、正しくインポートされていない。
  - 解決策: モジュールのインポート/エクスポートを確認し、コンストラクタ関数が正しく参照できるようにします。
Symbol.hasInstanceの誤用
- カスタムオブジェクトでSymbol.hasInstanceメソッドを使用している場合、実装に誤りがあるケースです。
  - 例: Symbol.hasInstanceメソッドが真偽値を返さない場合。
  - 解決策: Symbol.hasInstanceメソッドの実装を確認し、真偽値を返すように修正します。
フレームワークやライブラリのバグ
- 使用しているフレームワークやライブラリの内部でinstanceofが使用されている場合、そのフレームワークやライブラリのバグが原因でエラーが発生するケースがあります。
  - 解決策: フレームワークやライブラリのバージョンを更新するか、代替手段を検討します。

エラーメッセージの確認
- エラーメッセージをよく読み、どの部分でエラーが発生しているかを確認します。
デバッガの使用
- ブラウザの開発者ツールやNode.jsのデバッガを使用して、エラーが発生している箇所を特定し、変数の値を確認します。
コンソールログの出力
- console.log()を使用して、instanceofの右辺に指定している変数の型や値を出力し、期待される値になっているかを確認します。
コードの分割
- 複雑なコードの場合、コードを分割して、どの部分でエラーが発生しているかを特定します。
最小限の再現コード
- エラーを再現する最小限のコードを作成し、問題を特定しやすくします。
ドキュメントの参照
- JavaScriptのドキュメントや、使用しているフレームワークやライブラリのドキュメントを参照し、instanceofの正しい使い方を確認します。

プリミティブ値の誤用例

let myString = "こんにちは";
let myNumber = 123;

// エラー: 文字列リテラルはコンストラクタではない
// console.log(myString instanceof "String");

// エラー: 数値リテラルはコンストラクタではない
// console.log(myNumber instanceof 123);

// 正しい例: typeof演算子を使用
console.log(typeof myString === "string"); // true
console.log(typeof myNumber === "number"); // true

// 正しい例: ラッパーオブジェクトを使用 (一般的には推奨されない)
console.log(myString instanceof String); // false
console.log(new String(myString) instanceof String); // true
console.log(myNumber instanceof Number); // false
console.log(new Number(myNumber) instanceof Number); // true

説明

ラッパーオブジェクト(new String(), new Number())を使用することもできますが、プリミティブ値とラッパーオブジェクトは厳密には違うため、予期しない動作をする可能性があります。
typeof演算子を使用して型をチェックするのが一般的です。
文字列リテラルや数値リテラルをinstanceofの右辺に使用するとエラーになります。

オブジェクトリテラルの誤用例

let myObject = {};
let myArray = [1, 2, 3];

// エラー: オブジェクトリテラルはコンストラクタではない
// console.log(myArray instanceof {});

// エラー: 一般的なオブジェクトはコンストラクタではない
// console.log(myArray instanceof myObject);

// 正しい例: Arrayコンストラクタを使用
console.log(myArray instanceof Array); // true

// 正しい例: カスタムコンストラクタ関数を使用
function MyCustomObject() {}
let myCustomInstance = new MyCustomObject();
console.log(myCustomInstance instanceof MyCustomObject); // true

説明

Arrayなどの組み込みコンストラクタ関数や、カスタムコンストラクタ関数を使用する必要があります。
空のオブジェクトリテラルや、一般的なオブジェクトをinstanceofの右辺に使用するとエラーになります。

スコープの問題の例

function outerFunction() {
  function InnerConstructor() {}

  function innerFunction(obj) {
    // エラー: InnerConstructorはouterFunctionのスコープ内でのみ有効
    // console.log(obj instanceof InnerConstructor);
  }

  let innerInstance = new InnerConstructor();
  innerFunction(innerInstance);
}

// エラーが発生する状況の例
// let obj = new innerFunction.InnerConstructor();

// 正しい例: スコープ内でinstanceofを使用
function outerFunction2() {
  function InnerConstructor2() {}

  function innerFunction2(obj) {
    console.log(obj instanceof InnerConstructor2); // true
  }

  let innerInstance2 = new InnerConstructor2();
  innerFunction2(innerInstance2);
}

outerFunction2();

説明

instanceofは、コンストラクタ関数が定義されたスコープ内で使用する必要があります。
外部スコープから参照しようとするとエラーになります。
クロージャ内で定義されたコンストラクタ関数は、そのクロージャのスコープ内でのみ有効です。

モジュールシステムの誤用例

// moduleA.js
export function MyConstructor() {}

// moduleB.js
import { MyConstructor } from './moduleA.js';

let instance = new MyConstructor();

// 正しい例: 正しくインポートされたコンストラクタを使用
console.log(instance instanceof MyConstructor); // true

// moduleC.js
import { MyConstructor as MyConstructor2 } from './moduleA.js';
let instance2 = new MyConstructor2();
console.log(instance2 instanceof MyConstructor2); //true

// moduleD.js
import * as ModuleA from './moduleA.js';
let instance3 = new ModuleA.MyConstructor();
console.log(instance3 instanceof ModuleA.MyConstructor); //true

// moduleE.js
import { } from "./moduleA.js";
// let instance4 = new MyConstructor();
// console.log(instance4 instanceof MyConstructor); //エラー: MyConstructorが存在しないため

import * as ModuleA from './moduleA.js'; のようにモジュール全体をインポートする事も可能です。
import { MyConstructor as MyConstructor2 } from './moduleA.js'; のようにエイリアスを使用する事も可能です。
インポートされていないコンストラクタ関数をinstanceofで使用するとエラーになります。
モジュールシステムを使用している場合、コンストラクタ関数を正しくインポートする必要があります。

typeof演算子の使用

instanceofはオブジェクトのインスタンスチェックに特化しているため、プリミティブ値には使用できません。
プリミティブ値（文字列、数値、真偽値など）の型チェックには、typeof演算子が適しています。

let myString = "こんにちは";
let myNumber = 123;

console.log(typeof myString === "string"); // true
console.log(typeof myNumber === "number"); // true

constructorプロパティの使用

constructorプロパティは、オブジェクトが生成されたコンストラクタ関数への参照を保持します。
オブジェクトのコンストラクタ関数をチェックするには、constructorプロパティを使用できます。

let myArray = [1, 2, 3];
let myObject = {};

console.log(myArray.constructor === Array); // true
console.log(myObject.constructor === Object); // true

function MyCustomObject() {}
let myInstance = new MyCustomObject();
console.log(myInstance.constructor === MyCustomObject); // true

Object.prototype.toString.call()の使用

この方法は、オブジェクトの内部[[Class]]プロパティに基づいて型を判定します。
より正確な型チェックが必要な場合は、Object.prototype.toString.call()を使用できます。

let myArray = [1, 2, 3];
let myDate = new Date();

console.log(Object.prototype.toString.call(myArray) === "[object Array]"); // true
console.log(Object.prototype.toString.call(myDate) === "[object Date]"); // true

duck typing

instanceofのように厳密な型チェックは行いませんが、柔軟な型チェックが可能です。
オブジェクトの特定のメソッドやプロパティの有無に基づいて型を判定する方法です。

function processArrayLike(obj) {
  if (obj && typeof obj.length === "number" && typeof obj.forEach === "function") {
    // 配列のようなオブジェクトとして処理
    obj.forEach(item => console.log(item));
  } else {
    console.log("配列のようなオブジェクトではありません");
  }
}

processArrayLike([1, 2, 3]); // 1, 2, 3
processArrayLike({ length: 2, forEach: function(callback) { callback(1); callback(2); } }); // 1, 2
processArrayLike({}); // 配列のようなオブジェクトではありません

Array.isArray()の使用

配列かどうかを判定するには、Array.isArray()を使用するのが最も簡単で推奨される方法です。

let myArray = [1, 2, 3];
let myObject = {};

console.log(Array.isArray(myArray)); // true
console.log(Array.isArray(myObject)); // false

型ガード関数は、特定の型であるかどうかを判定し、TypeScriptなどの型システムと連携して型安全性を高めることができます。
複雑な型チェックが必要な場合は、カスタム型ガード関数を作成できます。

function isMyCustomObject(obj: any): obj is MyCustomObject {
  return obj && obj.myProperty !== undefined;
}

interface MyCustomObject {
  myProperty: string;
}

let myInstance: any = { myProperty: "test" };

if (isMyCustomObject(myInstance)) {
  console.log(myInstance.myProperty); // "test"
}

JavaScriptの「エラー: 予期しない型」を徹底解説！原因と解決策から代替方法まで

以下に、よくある原因と解決策をいくつか紹介します。型の不一致変数に代入したり、関数に引数として渡したりする値の型が、想定されていた型と一致していない場合に発生します。例：解決策：型変換を行う（例：parseInt(num)）変数の型宣言を正しく行う

【これさえあればOK】AggregateError.aggregateErrorでJavaScriptのエラー処理に関する疑問をすべて解決

使用方法: AggregateError() コンストラクター導入: ECMAScript 2021エラー処理のコードを簡潔に記述できる複数のエラーを一括して処理できる上記コードを実行すると、以下の出力が得られます。この例では、AggregateError() コンストラクターに errors 配列とエラーメッセージを渡しています。errors 配列には、個々のエラーオブジェクトが含まれます。エラーメッセージは、単一のエラーオブジェクトの説明に使用されます。

JavaScriptのAggregateError.errors: 詳細なエラー処理を可能にする強力なツール

以下に、AggregateError. errors の使用方法に関する具体的な例を示します。この例では、promise1 と promise2 は拒否され、promise3 は解決されます。Promise. any() 関数は、いずれかのプロミスが解決されると最初にその値を返し、すべてのプロミスが拒否されると AggregateError オブジェクトをスローします。

ループ処理を自由自在に操る！Array.@@iteratorでJavaScriptプログラミングをレベルアップ

Array. @@iterator は、JavaScript の Array オブジェクトに関連する特殊なメソッドです。このメソッドは、イテレータと呼ばれるオブジェクトを返します。イテレータは、ループ処理などで順序的に要素を処理するために使用されます。

JavaScriptのArrayにおける@@species：セキュリティとパフォーマンスの両立を実現

また、@@species は、特定の最適化を困難にする可能性があります。@@species の存在により、任意のコードを実行できる可能性があり、セキュリティ上の脆弱性を生み出す可能性があるため、注意が必要です。主に、サブクラス化された Array オブジェクトで、メソッドからの返値を元の Array コンストラクターではなく、サブクラスのコンストラクターを使用して生成できるようにするために使用されます。

【初心者向け】JavaScriptの配列操作「Array.copyWithin」の使い方を分かりやすく解説

Array. copyWithinメソッドは、JavaScriptの配列の一部を別の位置にシャローコピーする機能を提供します。元の配列の長さは変更されず、コピー範囲外の要素はそのまま保持されます。構文引数end (オプション): コピーの終了インデックス (デフォルトは array

JavaScriptで配列を同じ値で埋める方法：fill()メソッド vs forEachループ vs mapメソッド

Array. prototype. fill() メソッドは、JavaScript における配列の要素を指定した値で置き換えるために使用されます。これは、配列内のすべての要素を一括で変更したい場合に便利な方法です。構文パラメータend (オプション): 置き換えを終了するインデックス (デフォルトは配列の長さ)

JavaScriptの便利ツール `Array.flat()` でネストをバッサリ！詳細ガイドと代替方法も

Array. flat() メソッドは、再帰的にネストされた配列をすべてフラット化します。つまり、すべてのサブ配列を、その要素に置き換えます。この処理は、引数として渡された depth の値まで繰り返されます。負の depth 値は、無限大の深さまでフラット化することを意味します。

JavaScriptで配列を扱うならこれ一択！`Array.from`メソッドの徹底解説

Array. fromは、引数として渡されたオブジェクトを新しい配列に変換する静的メソッドです。このメソッドは、配列以外にも、文字列、数値セット、ジェネレータなど、さまざまな種類のオブジェクトを変換することができます。基本的な構文は以下の通りです。

【JavaScript】配列作成をもっとスマートに！ `Array.of` メソッド徹底解説

Array. of メソッドは、ゼロ個以上の値をカンマ区切りで渡すことで、新しい配列を作成します。各値は、配列の要素として個別に格納されます。構文は以下の通りです。安全性型推論により、要素の型を明示的に記述する必要がありません。汎用性配列以外にも、TypedArray やカスタムオブジェクトの作成にも使用できます。