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/includes/index.html | 135 +++++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 files/uk/web/javascript/reference/global_objects/array/includes/index.html (limited to 'files/uk/web/javascript/reference/global_objects/array/includes') diff --git a/files/uk/web/javascript/reference/global_objects/array/includes/index.html b/files/uk/web/javascript/reference/global_objects/array/includes/index.html new file mode 100644 index 0000000000..3030f78d9f --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/array/includes/index.html @@ -0,0 +1,135 @@ +--- +title: Array.prototype.includes() +slug: Web/JavaScript/Reference/Global_Objects/Array/includes +tags: + - Array + - JavaScript + - Method + - Prototype + - polyfill + - Довідка + - Масив +translation_of: Web/JavaScript/Reference/Global_Objects/Array/includes +--- +
{{JSRef}}
+ +

Метод includes() з'ясовує, чи масив містить елемент із вказаним значенням, та вертає відповідно true або false.

+ +

{{EmbedInteractiveExample("pages/js/array-includes.html")}}

+ + + +

Синтаксис

+ +
arr.includes(valueToFind[, fromIndex])
+ +

Параметри

+ +
+
valueToFind
+
Значення елемента, який слід знайти.
+
+ +
+

Примітка: При порівнянні рядків та літер, includes() чутливий до регістру.

+
+ +
+
fromIndex {{optional_inline}}
+
Позиція у масиві, з якої потрібно починати пошук valueToFind; перша літера шукатиметься за індексом fromIndex, якщо fromIndex є позитивним значенням, або за індексом array.length + fromIndex, якщо fromIndex від'ємний (використовуючи {{interwiki("wikipedia", "Модуль_(математика)", "абсолютну величину")}} fromIndex як кількість літер з кінця масиву, де потрібно починати пошук). За замовчуванням дорівнює 0.
+
+ +

Вертає

+ +

Значення {{jsxref("Boolean")}}, яке дорівнює true, якщо значення valueToFind знайдене у масиві (або у частині масиву, якщо заданий параметр fromIndex). Всі нульові значення вважаються рівними, незалежно від знаку (тому -0 вважатиметься рівним і 0, і +0), але false не вважається тим самим, що й 0.

+ +
+

Примітка: Технічно кажучи, includes() використовує алгоритм sameValueZero для визначення того, чи знайдено заданий елемент.

+
+ +

Приклади

+ +
[1, 2, 3].includes(2);      // true
+[1, 2, 3].includes(4);      // false
+[1, 2, 3].includes(3, 3);   // false
+[1, 2, 3].includes(3, -1);  // true
+[1, 2, NaN].includes(NaN);  // true
+
+ +

fromIndex більший або дорівнює довжині масиву

+ +

Якщо fromIndex дорівнює або перевищує довжину масиву, пошук не здійснюється й завжди вертається false:

+ +
var arr = ['a', 'b', 'c'];
+
+arr.includes('c', 3);    // вертає false
+arr.includes('c', 100);  // вертає false
+ +

Обчислений індекс менший за 0

+ +

Якщо значення fromIndex від'ємне, використовується обчислений індекс для визначення позиції, з якої починати пошук valueToFind у масиві. Якщо обчислений індекс менший або дорівнює -1 * array.length, пошук здійснюється у всьому масиві.

+ +
// Довжина масиву дорівнює 3
+// fromIndex дорівнює -100
+// Обчислений індекс дорівнює 3 + (-100) = -97
+
+var arr = ['a', 'b', 'c'];
+
+arr.includes('a', -100); // true
+arr.includes('b', -100); // true
+arr.includes('c', -100); // true
+arr.includes('a', -2); // false
+ +

Застосування includes() як загального метода

+ +

Реалізація метода includes() є зумисне узагальненою. Об'єкт, на який вказує this, не обов'язково повинен належати до класу Array, тож використання includes() можна поширити на інші масивоподібні об'єкти. В наведеному нижче прикладі його застосовано до об'єкта {{jsxref("Functions/arguments", "arguments")}}:

+ +
(function() {
+  console.log([].includes.call(arguments, 'a'));  // виводить true
+  console.log([].includes.call(arguments, 'd'));  // виводить false
+})('a','b','c');
+
+ + + +

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

+ + + + + + + + + + + + + + + + + + + +
СпецифікаціяСтатусКоментар
{{SpecName('ESDraft', '#sec-array.prototype.includes', 'Array.prototype.includes')}}{{Spec2('ESDraft')}}
{{SpecName('ES7', '#sec-array.prototype.includes', 'Array.prototype.includes')}}{{Spec2('ES7')}}Початкова виознака.
+ +

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

+ + + +

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

+ +

Див. також

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