includes() в JavaScript: что это?
includes() — это один из основных методов, встроенных в язык программирования JavaScript, работает из коробки стандартной библиотеки Node.js.
includes() используют, чтобы определить, содержит ли строка указанные символы (этот метод возвращает true или false).
При этом строка (string или str) — это любая последовательность символов, строковый тип данных. Пустая строка — тоже строка.
includes() в JavaScript: результат работы
Важно! includes() чувствителен к регистру. Ошибка в регистре при работе с этим методом вернёт false там, где ожидается true.
includes() в JavaScript: полезные ссылки
Техническая документация по JavaScript выложена на сайте Mozilla (MDN web docs), там есть раздел про includes().
Для более глубокого понимания может быть полезным сайт ECMA-262 (стандарт JavaScript — 2026). Там есть раздел про includes().
includes() в JavaScript: полное название
Полное название частично раскрывает внутреннюю реализацию includes() разработчиками JavaScript.
Код этой реализации может быть выложен в разделе Polyfill на сайте MDN, но не для всех встроенных методов и/или не на всех языках.
Для метода includes() такой раздел не выложен.
includes() в JavaScript: синтаксис и параметры
Важно! Метод includes() принимает один обязательный параметр (searchString), то есть подстроку для поиска, и один необязательный параметр [position], то есть позицию, с которой начинается поиск. По умолчанию она равна 0.
См. возможные значения этих параметров в разделе «Частые вопросы».
При этом параметр — это то, что передано в функцию, а функция — это фрагмент кода, который вычисляет что-либо на основании параметров, которые в неё переданы.
includes() в JavaScript: пример использования
Если запустить этот код, то вернётся true.
Для запуска кода с целью тренировки можно использовать онлайн-песочницу JavaScript, например runjs.app.
includes() в JavaScript: FAQ
- Чувствителен ли метод includes() к регистру?
Ответ: Он чувствителен к регистру и при ошибке в регистре в параметре (searchString) вернёт false там, где ожидается true.
- Какие значения может принимать параметр (searchString) в методе includes()?
Ответ: Любые значения кроме регулярного выражения (regexp) будут приведены к строковому типу (string).
- Что если параметр (searchString) в методе includes() является регулярным выражением (regexp)?
Ответ: В этом случае программа вернёт ошибку TypeError.
- Что если параметр (searchString) в методе includes() является пустой строкой?
Ответ: В этом случае программа вернёт true.
- Что если параметр (searchString) в методе includes() равен undefined?
Ответ: В этом случае программа будет искать строку "undefined" и вряд ли найдёт её.
- Что если параметр [position] в методе includes() больше длины строки?
Ответ: В этом случае программа вернёт false.
- С какими браузерами совместим метод includes()?
Ответ: Он совместим со всеми основными современными браузерами (май 2025).
===
Я учусь в онлайн-школе по программе fullstack (разработка полного цикла) и буду рад, если этот материал окажется полезным для вас.