← 返回首页
String.prototype.includes() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Веб-технологии для разработчиков
  2. JavaScript
  3. Справочник по JavaScript
  4. Стандартные встроенные объекты
  5. String
  6. String.prototype.includes()
Theme
  • OS default
  • Light
  • Dark
Русский
Remember language Learn more

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

String.prototype.includes()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since сентябрь 2015 г..

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

In this article

Интерактивный пример

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"

Синтаксис

js
includes(searchString) includes(searchString, position)

Параметры

searchString

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

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

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

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

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

Исключения

TypeError

Возникает если searchString является регулярным выражением.

Описание

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

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

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

js
"Синий кит".includes("синий"); // false

Для обхода этого ограничения можно преобразовать обе строки в нижний регистр:

js
"Синий кит".toLowerCase().includes("синий"); // true

Примеры

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

js
const 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

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

Specification
ECMAScript® 2027 Language Specification
# sec-string.prototype.includes

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

Enable JavaScript to view this browser compatibility table.

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

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 17 февр. 2025 г. by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Стандартные встроенные объекты
  2. String
  3. Конструктор
    1. String()
  4. Статические методы
    1. String.fromCharCode()
    2. String.fromCodePoint()
    3. String.raw()
  5. Методы экземпляра
    1. String.prototype.anchor()
    2. at()
    3. String.prototype.big()
    4. String.prototype.blink()
    5. String.prototype.bold()
    6. String.prototype.charAt()
    7. String.prototype.charCodeAt()
    8. String.prototype.codePointAt()
    9. String.prototype.concat()
    10. String.prototype.endsWith()
    11. String.prototype.fixed()
    12. String.prototype.fontcolor()
    13. String.prototype.fontsize()
    14. String.prototype.includes()
    15. String.prototype.indexOf()
    16. isWellFormed()
    17. String.prototype.italics()
    18. String.prototype.lastIndexOf()
    19. String.prototype.link()
    20. String.prototype.localeCompare()
    21. String.prototype.match()
    22. String.prototype.matchAll()
    23. String.prototype.normalize()
    24. String.prototype.padEnd()
    25. String.prototype.padStart()
    26. String.prototype.repeat()
    27. String.prototype.replace()
    28. String.prototype.replaceAll()
    29. String.prototype.search()
    30. String.prototype.slice()
    31. String.prototype.small()
    32. String.prototype.split()
    33. String.prototype.startsWith()
    34. String.prototype.strike()
    35. String.prototype.sub()
    36. String.prototype.substr()
    37. String.prototype.substring()
    38. String.prototype.sup()
    39. String.prototype.toLocaleLowerCase()
    40. String.prototype.toLocaleUpperCase()
    41. String.prototype.toLowerCase()
    42. String.prototype.toString()
    43. String.prototype.toUpperCase()
    44. toWellFormed()
    45. String.prototype.trim()
    46. String.prototype.trimRight()
    47. String.prototype.trimLeft()
    48. String.prototype.valueOf()
    49. String.prototype[@@iterator]()
  6. Свойства экземпляра
    1. String.length
  7. Наследование
  8. Object/Function
  9. Статические методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  10. Статические свойства
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  11. Методы экземпляра
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  12. Свойства экземпляра
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.