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

Метод includes() визначає чи може один рядок бути знайденим всередині іншого, повертаючи, відповідно, true або false.

+ +

{{EmbedInteractiveExample("pages/js/string-includes.html", "shorter")}}

+ + + +

Синтаксис

+ +
str.includes(searchString[, position])
+ +

Параметри

+ +
+
searchString
+
Рядок для пошуку всередині str.
+
position {{optional_inline}}
+
Позиція всередині рядка, з якої буде почато пошук рядка searchString. (За замовчуванням 0).
+
+ +

Значення, що повертається

+ +

true, якщо шуканий рядок знайдено де-завгодно всередині наданого рядка; інакше, false.

+ +

Опис

+ +

Цей метод дозволяє визначити чи знаходиться один рядок всередині іншого.

+ +

Чутливість до регістру

+ +

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

+ +
'Синій кит'.includes('синій'); // вертає false
+
+ +

Приклади

+ +

Використання includes()

+ +
var str = 'Питання в тому: бути чи не бути.';
+
+console.log(str.includes('Питання'));     // true
+console.log(str.includes('бути'));        // true
+console.log(str.includes('неіснуючий'));  // false
+console.log(str.includes('Питання', 1));  // false
+console.log(str.includes('ПИТАННЯ'));     // false
+console.log(str.includes(''));            // true
+ +

Поліфіл

+ +

Цей метод був доданий до специфікації ECMAScript 2015 і може бути недоступним у всіх реалізаціях JavaScript.

+ +

Однак, ви можете легко розробити поліфіл для цього методу:

+ +
if (!String.prototype.includes) {
+  String.prototype.includes = function(search, start) {
+    'use strict';
+
+    if (search instanceof RegExp) {
+      throw TypeError('first argument must not be a RegExp');
+    }
+    if (start === undefined) { start = 0; }
+    return this.indexOf(search, start) !== -1;
+  };
+}
+ +

+ +

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

+ + + + + + + + + + +
Специфікація
{{SpecName('ESDraft', '#sec-string.prototype.includes', 'String.prototype.includes')}}
+ +

Сумісність з веб-переглядачами

+ + + +

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

+ +

String.prototype.contains

+ +

У Firefox 18-39 назва цього методу була contains(). Він був перейменований на includes() у bug 1102219 у зв'язку з наступною причиною:

+ +

Повідомлялося, що деякі веб-сайти, які використовують MooTools 1.2 не працюють на Firefox 17. Ця версія MooTools перевіряла чи існує метод String.prototype.contains() та, якщо ні, то MooTools додає власну функцію.

+ +

З введенням цієї функції у Firefox 17, поведінка цієї перевірки змінювалася таким чином, що ставала причиною непрацездатності коду на основі реалізації методу String.prototype.contains() від MooTools. В результаті реалізація була відключена у Firefox 17, а String.prototype.contains() був доступний на одну версію пізніше, у Firefox 18, коли налагодження зв'язків з MooTools призвело до випуску MooTools версії 1.2.6.

+ +

MooTools 1.3 примусово запускає власну версію методу String.prototype.contains(), тож, веб-сайти, що покладаються на неї, не повинні ламатися. Однак, зауважте, що сигнатура цього методу відразняється для MooTools 1.3 і ECMAScript 2015 (на місці другого аргумента). Пізніше, MooTools 1.5+ змінив сігнатуру у відповідності до стандарту ES2015.

+ +

У Firefox 48 метод String.prototype.contains() було видалено. Використовуйте тільки String.prototype.includes().

+ +

Див. також

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