String.prototype.includes()

Метод includes() значений String выполняет поиск с учетом регистра, чтобы определить, может ли данная строка быть найдена внутри этой строки, возвращая true или false соответственно.

Попробуйте

const sentence = "The quick brown fox jumps over the lazy dog.";

const word = "fox";

console.log(
  `The word "${word}" ${
    sentence.includes(word) ? "is" : "is not"
  } in the sentence`,
);
// Expected output: "The word "fox" is in the sentence"

Синтаксис

includes(searchString)
includes(searchString, position)

Параметры

searchString

Строка, которую нужно искать в str. Не может быть регулярным выражением. Все значения, не являющиеся регулярными выражениями, приводятся к строкам, поэтому пропуск или передача undefined приводит к тому, что includes() ищет строку "undefined", что редко является желаемым результатом.

position Необязательно

Позиция в строке, с которой следует начать поиск searchString. (По умолчанию 0.)

Возвращаемое значение

true, если искомая строка найдена где-либо внутри данной строки, в том числе, когда searchString является пустой строкой; в противном случае, false.

Исключения

TypeError

Выбрасывается, если searchString является регулярным выражением.

Описание

Этот метод позволяет определить, содержит ли строка другую строку.

Чувствительность к регистру

Метод includes() чувствителен к регистру. Например, следующее выражение возвращает false:

"Blue Whale".includes("blue"); // returns false

Вы можете обойти это ограничение, преобразовав как исходную строку, так и искомую строку в нижний регистр:

"Blue Whale".toLowerCase().includes("blue"); // returns true

Примеры

Использование includes()

const str = "To be, or not to be, that is the question.";

console.log(str.includes("To be")); // true
console.log(str.includes("question")); // true
console.log(str.includes("nonexistent")); // false
console.log(str.includes("To be", 1)); // false
console.log(str.includes("TO BE")); // false
console.log(str.includes("")); // true

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

Совместимость с браузерами

Смотрите также

• Полифил String.prototype.includes в core-js
• Полифил String.prototype.includes es-shims
• Array.prototype.includes()
• TypedArray.prototype.includes()
• String.prototype.indexOf()
• String.prototype.lastIndexOf()
• String.prototype.startsWith()
• String.prototype.endsWith()