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。
js
Array.isArray([1, 2, 3]); // trueArray.isArray({ foo: 123 }); // falseArray.isArray("foobar"); // falseArray.isArray(undefined); // false語法
js
Array.isArray(obj)參數
obj要檢查的物件。
回傳值
若物件為Array 回傳true；否則回傳false。
描述
檢查傳入的物件是否為陣列（Array），如果是便回傳true，否則回傳false。
更多細節請參考「Determining with absolute accuracy whether or not a JavaScript object is an array」。
範例
js
// 下方都回傳 trueArray.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);// 下方都回傳 falseArray.isArray();Array.isArray({});Array.isArray(null);Array.isArray(undefined);Array.isArray(17);Array.isArray("Array");Array.isArray(true);Array.isArray(false);Array.isArray({ __proto__: Array.prototype });instanceof vsisArray
當檢查Array 實例時，Array.isArray 相較於instanceof 更加推薦，因為它可以穿透iframes。
js
var iframe = document.createElement("iframe");document.body.appendChild(iframe);xArray = window.frames[window.frames.length - 1].Array;var arr = new xArray(1, 2, 3); // [1,2,3]// 正確地檢查陣列型態Array.isArray(arr); // true// 有害地，因為它不能在 iframes 之間正常運作arr instanceof Array; // falsePolyfill
如果Array.isArray() 不存在於你的環境，在其他程式碼前執行下列程式碼可建置Array.isArray()。
js
if (!Array.isArray) { Array.isArray = function (arg) { return Object.prototype.toString.call(arg) === "[object Array]"; };}規範
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.isarray |