【Node.js24.x】Array::isArray()メソッドの使い方

isArrayメソッドは、指定された値が配列（Arrayオブジェクト）であるかどうかを判定するメソッドです。このメソッドは、引数として渡された値がJavaScriptの標準的なArrayオブジェクトのインスタンスである場合にのみ真（true）を返します。それ以外の値、例えば数値、文字列、オブジェクトリテラル、null、undefined、関数などに対しては偽（false）を返します。

特に、異なるJavaScript実行環境（例えばWebブラウザのiframeやWeb Worker）から渡されたオブジェクトが配列であるかどうかを安全かつ確実にチェックしたい場合に、このメソッドは非常に有用です。従来のinstanceof演算子を用いた判定方法と比較して、Array.isArray()はより堅牢な判定を提供します。なぜなら、instanceofは異なるグローバルコンテキストで作成された配列オブジェクトに対しては正しく機能しない可能性があるためです。

システムエンジニアを目指す方にとって、変数にどのような型のデータが格納されているかを確認することは、プログラムの正確性と安全性を保つ上で不可欠です。Array.isArray()を使用することで、意図せず配列ではない値が渡された場合の処理を事前に防ぎ、予期せぬエラーの発生を抑制し、信頼性の高いプログラムを構築することができます。

Copy
1const valueIfArray = [1, 2, 3];
2const valueIfNotArray = { key: 'value' };
3
4console.log(Array.isArray(valueIfArray));   // true を返す
5console.log(Array.isArray(valueIfNotArray)); // false を返す

value

• value: any: 配列かどうかを判定したい値

boolean

指定された値が配列である場合に true を、そうでない場合に false を返します。