JavaScript метод isArray()

JavaScript Array

Определение и применение

JavaScript метод isArray() определяет и возвращает логическое значение true в том случае, если переданное значение является массивом и false, если оно не является массивом.

Поддержка браузерами

МетодChrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
Edge
isArray()ДаДаДаДа9.0Да

JavaScript синтаксис:

Array.isArray( obj );

Версия JavaScript

ECMAScript 5.1 (реализована в JavaScript 1.8.5)

Значения параметров

ПараметрОписание
objОбъект, подлежащий проверке. Обязательное значение.

Пример использования

<!DOCTYPE html>
<html>
	<head>
		<title>Использование JavaScript метода isArray()</title>
	</head>
	<body>
		<button onclick = "myFunc()">Клик</button> <!-- добавляем атрибут событий onclick -->
		<div id = "result"></div>
		<script>
	var test = [[], {}, true, [1, 2, 3], new Array()]; // создаем переменную, содержащую массив данных 

	function myFunc() {
	  var out = ""; // инициализируем пустую строковую переменную
	  for (var i = 0; i < test.length; i++) {  // проходим циклом по каждому элементу массива
	    out += Array.isArray( test[i] ) + "<br>"; // проверяем является ли текущий элемент массивом и помещаем результат проверки в переменную
	  }
	  document.getElementById("result").innerHTML = out; // добавляем содержимое переменной out в элемент с глобальным атрибутом id result
	}		
		</script>
	</body>
</html>

В этом примере мы с использованием атрибута событий onclick при нажатии на кнопку (HTML элемент <button>) вызываем функцию myFunc(), которая позволяет пройти циклом по каждому элементу массива test и с использованием JavaScript метода .isArray() проверить является ли текущий элемент массива массивом, после этого с помощью свойства innerHTML поместить результат проверки в элемент <div> с глобальным атрибутом id result.

Результат нашего примера:

Пример использования JavaScript метода pop()
Пример использования JavaScript метода isArray()

Ниже представлены примеры вызова метода isArray() как с логическим результатом true, так и false:

// Все следующие вызовы вернут true
Array.isArray([]);
Array.isArray([undefined]);
Array.isArray([1]);
Array.isArray(new Array());
Array.isArray(Array.prototype);

// вызовы, которые вернут false
Array.isArray(); 
Array.isArray({});
Array.isArray(1);
Array.isArray("String");
Array.isArray(null);
Array.isArray(undefined);
Array.isArray(true);
Array.isArray(false);
Array.isArray({ __proto__: Array.prototype });
JavaScript Array