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 생성자의 신원이 달라instanceof Array가 실패할 수 있는 교차 영역 객체와 함께 사용하는 것이 안전합니다.

자세한 내용은"Determining with absolute accuracy whether or not a JavaScript object is an array"(JavaScript 객체가 배열인지 여부를 절대적인 정확도로 확인하기) 글을 참조하세요.

또한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 확인 방법Array.isArray(arr); // true// arr의 프로토타입은 Array.prototype와 다른 객체인 xArray.prototype입니다.arr instanceof Array; // false