From 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:43:23 -0500 Subject: initial commit --- .../global_objects/array/isarray/index.html | 131 +++++++++++++++++++++ 1 file changed, 131 insertions(+) create mode 100644 files/uk/web/javascript/reference/global_objects/array/isarray/index.html (limited to 'files/uk/web/javascript/reference/global_objects/array/isarray/index.html') diff --git a/files/uk/web/javascript/reference/global_objects/array/isarray/index.html b/files/uk/web/javascript/reference/global_objects/array/isarray/index.html new file mode 100644 index 0000000000..8f7b888535 --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/array/isarray/index.html @@ -0,0 +1,131 @@ +--- +title: Array.isArray() +slug: Web/JavaScript/Reference/Global_Objects/Array/isArray +tags: + - Array + - ECMAScript5 + - JavaScript + - Method + - polyfill + - Довідка +translation_of: Web/JavaScript/Reference/Global_Objects/Array/isArray +--- +
{{JSRef}}
+ +
Метод Array.isArray() з'ясовує, чи є передане значення {{jsxref("Array", "масивом")}}.
+ +
+ +
Array.isArray([1, 2, 3]);    // true
+Array.isArray({foo: 123});   // false
+Array.isArray('foobar');     // false
+Array.isArray(undefined);    // false
+
+ +

Синтакс

+ +
Array.isArray(value)
+ +

Параметри

+ +
+
value
+
Значення, яке має бути перевірено.
+
+ +

Вертає

+ +

Значення true, якщо value є {{jsxref("Array", "масивом")}}; false — якщо ні.

+ +

Опис

+ +

Якщо передане значення є {{jsxref("Array", "масивом")}}, повертається true, інакше повертається false.

+ +

Більш докладні відомості дивіться у статті «Як з'ясувати абсолютно точно, чи є об'єкт у JavaScript масивом». При використанні екземпляра {{jsxref("TypedArray")}} завжди повертається false.

+ +

Приклади

+ +
//Всі наведені далі виклики вертають 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.isArray({ __proto__: Array.prototype });
+ +

instanceof проти isArray

+ +

Для перевірки, чи є об'єкт екземпляром Array, метод Array.isArray підходить краще, ніж instanceof, тому що він працює між фреймами (iframes).

+ +
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
+Array.isArray(arr);  // true
+// Вважається небезпечним, бо не працює між фреймами
+arr instanceof Array; // false
+ +

Запасний варіант (поліфіл)

+ +

Наступний код, запущений перед будь-яким іншим кодом, створить метод Array.isArray(), якщо він недоступний початково.

+ +
if (!Array.isArray) {
+  Array.isArray = function(arg) {
+    return Object.prototype.toString.call(arg) === '[object Array]';
+  };
+}
+
+ +

Специфікації

+ + + + + + + + + + + + + + + + + + + + + + + + +
СпецифікаціяСтатусКоментар
{{SpecName('ES5.1', '#sec-15.4.3.2', 'Array.isArray')}}{{Spec2('ES5.1')}}Початкова виознака. Запроваджено у JavaScript 1.8.5.
{{SpecName('ES6', '#sec-array.isarray', 'Array.isArray')}}{{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-array.isarray', 'Array.isArray')}}{{Spec2('ESDraft')}}
+ +

Підтримка веб-переглядачами

+ + + +

{{Compat("javascript.builtins.Array.isArray")}}

+ +

Див. також

+ + -- cgit v1.2.3-54-g00ecf