CKTIS / JavaScript
String.prototype.includes — проверка за наличие на подниз
String.prototype.includes проверява дали даден текст съдържа посочен подниз и връща true или false. Методът различава главни и малки букви, позволява задаване на начална позиция и не приема обикновени регулярни изрази.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
str.includes(searchString)
str.includes(searchString, position)String.prototype.includes търси буквален подниз и връща true или false, без да променя текста. Методът различава главни и малки букви и сравнява UTF-16 кодови единици: не нормализира Unicode и не прилага правила за сравнение, специфични за отделни езици.
Незадължителният параметър position задава най-ранния индекс за начало на съвпадение, броен от нула в UTF-16 кодови единици. Стойността по подразбиране е 0; след преобразуване в число дробната част се отрязва към нулата, а резултатът се ограничава в диапазона от 0 до дължината на текста. Ако методът стигне до самото търсене, той връща true при празен searchString, дори когато зададената позиция надвишава дължината на текста. Преобразуването на position обаче се извършва преди търсенето: подаването на стойност от тип BigInt като position предизвиква TypeError дори при празен searchString.
Обикновен обект RegExp, използван като searchString, предизвиква TypeError; формално това се определя от проверката IsRegExp, която взема предвид Symbol.match. Останалите аргументи за търсене се преобразуват в текст, така че при пропуснат аргумент се търси "undefined". Извикването на метода с null или undefined като this предизвиква TypeError.
Това е метод от стандартната библиотека на ECMAScript, а не Web API. Поддръжката в конкретен браузър трябва да се провери отделно; наличието му в Node 24 не доказва поддръжка в браузърите.
Примери
const text = "JavaScript";
console.log(text.includes("Script"));
console.log(text.includes("script"));
console.log(text.includes("Java", 1));
console.log(text.includes("", 99));
try {
text.includes(/Script/);
} catch (error) {
console.log(error.name);
}Резултат
true false false true TypeError
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.