From 95aca4b4d8fa62815d4bd412fff1a364f842814a Mon Sep 17 00:00:00 2001 From: Ryan Johnson Date: Thu, 29 Apr 2021 16:16:42 -0700 Subject: remove retired locales (#699) --- .../global_objects/array/includes/index.html | 135 --------------------- 1 file changed, 135 deletions(-) delete mode 100644 files/uk/web/javascript/reference/global_objects/array/includes/index.html (limited to 'files/uk/web/javascript/reference/global_objects/array/includes/index.html') 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 deleted file mode 100644 index 3030f78d9f..0000000000 --- a/files/uk/web/javascript/reference/global_objects/array/includes/index.html +++ /dev/null @@ -1,135 +0,0 @@ ---- -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