HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
View in English Always switch to English
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
Array.isArray() 静的メソッドは、渡された値が Array かどうかを判断します。
Array.isArray()
Array
console.log(Array.isArray([1, 3, 5])); // 予想される結果: true console.log(Array.isArray("[]")); // 予想される結果: false console.log(Array.isArray(new Array(5))); // 予想される結果: true console.log(Array.isArray(new Int16Array([15, 33]))); // 予想される結果: false
Array.isArray(value)
value
チェックするオブジェクト。
value が Array の場合は true です。そうでなければ false を返します。 value が TypedArray インスタンスであった場合は常に false を返します。
true
false
TypedArray
Array.isArray() は、渡された値が Array であるかどうかを調べます。これは、 in 演算子と同様に、 Array() コンストラクターによって初期化されたプライベートフィールドに対して「ブランドチェック」を行います。
in
Array()
これは、誤検知や誤検出を避けることができるため、 instanceof Array のより堅牢な代替手段となります。
instanceof Array
Array.prototype
詳しくは、 "Determining with absolute accuracy whether or not a JavaScript object is an array" を参照してください。
// 以下の呼び出しはすべて 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 });
Array のインスタンスをチェックする際、 Array.isArray は領域を超えても動作するので、 instanceof よりも推奨されます。
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
Enable JavaScript to view this browser compatibility table.
core-js