База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

String.prototype.indexOf — намиране на подниз

String.prototype.indexOf връща индекса на първото срещане на подниза от позицията, получена след преобразуване и ограничаване на position, или -1, ако няма съвпадение. Методът различава главни и малки букви, а индексите се измерват в кодови единици UTF-16.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

string.indexOf(searchString)
string.indexOf(searchString, position)

String.prototype.indexOf търси буквален подниз, без да променя текста. Търсенето започва от позицията, получена след преобразуване и ограничаване на position. Методът връща индекса на първото съвпадение или -1, ако няма съвпадение. Индексите започват от 0 и обозначават кодови единици UTF-16, а не непременно цели видими знаци. Търсенето различава главни и малки букви.

Незадължителният аргумент position по подразбиране е 0. Той се преобразува в цяло число чрез отрязване на дробната част към нулата, след което се ограничава в диапазона от 0 до дължината на текста. NaN означава 0. Ако преобразуването на position е успешно и searchString е празен низ, методът връща така получената позиция, дори ако тя е в края на текста. Ако подадете 0n като стойност на position, методът хвърля изключение TypeError, преди да започне търсенето.

searchString се преобразува в низ; ако аргументът е пропуснат, се търси "undefined". Методът не интерпретира регулярни изрази: подаден обект RegExp също се преобразува в низ.

Проверявайте дали поднизът присъства с result !== -1, а не с if (result): индекс 0 е falsy, докато -1 е truthy. В примера position променя откъде започва търсенето, но върнатият индекс продължава да се отнася за целия текст.

Примери

const text = "banana";
console.log(text.indexOf("ana"));
console.log(text.indexOf("ana", 2));
console.log(text.indexOf("B"));
console.log(text.indexOf("", 99));
console.log(text.indexOf("ban") !== -1);

Резултат

1
3
-1
6
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници