Array.isArray()

BaselineWidely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Array.isArray() 静的メソッドは、渡された値がArray かどうかを判断します。

試してみましょう

console.log(Array.isArray([1, 3, 5]));// Expected output: trueconsole.log(Array.isArray("[]"));// Expected output: falseconsole.log(Array.isArray(new Array(5)));// Expected output: trueconsole.log(Array.isArray(new Int16Array([15, 33])));// Expected output: false

構文

Array.isArray(value)

返値

value がArray の場合はtrue です。そうでなければfalse を返します。value がTypedArray インスタンスであった場合は常にfalse を返します。

Array.isArray() は、渡された値がArray であるかどうかを調べます。値のプロトタイプチェーンを調べたり、Array コンストラクターに頼っているわけではありません。配列リテラル構文またはArray コンストラクターを使用して作成した値に対してはtrue を返します。このため、Array コンストラクターの ID が異なり、instanceof Array が失敗してしまうような領域を超えるオブジェクトでも安全に使用することができます。

詳しくは、"Determining with absolute accuracy whether or not a JavaScript object is an array" を参照してください。

また、Array.isArray() はArray.prototype をプロトタイプチェーンに持つオブジェクトも拒否しますが、instanceof Array が受け入れる実際の配列ではありません。

例

Array.isArray() の使用

// 以下の呼び出しはすべて true を返しますArray.isArray([]);Array.isArray([1]);Array.isArray(new Array());Array.isArray(new Array("a", "b", "c", "d"));Array.isArray(new Array(3));// あまり知られていないものの Array.prototype は配列ですArray.isArray(Array.prototype);// 以下の呼び出しはすべて false を返しますArray.isArray();Array.isArray({});Array.isArray(null);Array.isArray(undefined);Array.isArray(17);Array.isArray("Array");Array.isArray(true);Array.isArray(false);Array.isArray(new Uint8Array(32));// これは配列ではありません。配列リテラルを使用した構文でも、// Array コンストラクターでもないからです。Array.isArray({ __proto__: Array.prototype });

instanceof と Array.isArray()

Array のインスタンスをチェックする際、Array.isArray は領域を超えても動作するので、instanceof よりも推奨されます。

const iframe = document.createElement("iframe");document.body.appendChild(iframe);const xArray = window.frames[window.frames.length - 1].Array;const arr = new xArray(1, 2, 3); // [1, 2, 3]// 配列を正しくチェックできますArray.isArray(arr); // true// arr のプロトタイプは xArray.prototype であり、// Array.prototype とは異なるオブジェクトです。arr instanceof Array; // false