Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

String.prototype.indexOf — hledání podřetězce

String.prototype.indexOf vrací index prvního výskytu podřetězce od pozice získané převodem a omezením hodnoty position, nebo -1, pokud nenajde shodu. Rozlišuje velká a malá písmena a indexy počítá v jednotkách kódu UTF-16.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

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

String.prototype.indexOf hledá doslovný podřetězec, aniž by měnil text. Hledání začíná na pozici získané převodem a omezením hodnoty position. Metoda vrací index první shody, nebo -1, pokud žádnou nenajde. Indexy začínají na 0 a označují jednotky kódu UTF-16, nikoli nutně celé viditelné znaky. Při hledání se rozlišují velká a malá písmena.

Volitelný argument position má výchozí hodnotu 0. Převede se na celé číslo oříznutím desetinné části směrem k nule a poté se omezí na rozsah od 0 do délky textu. NaN znamená 0. Pokud se převod position podaří a searchString je prázdný řetězec, metoda vrátí takto určenou pozici, i když je na konci textu. Předáte-li jako position hodnotu 0n, metoda vyvolá výjimku TypeError ještě před zahájením hledání.

searchString se převede na řetězec; pokud argument vynecháte, hledá se "undefined". Metoda nevyhodnocuje regulární výrazy: i předaný objekt RegExp se převede na řetězec.

Přítomnost podřetězce ověřujte pomocí result !== -1, nikoli pomocí if (result): index 0 je falsy, zatímco -1 je truthy. V příkladu position mění místo, od kterého hledání začíná, ale vrácený index se stále vztahuje k celému textu.

Příklady

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);

Výsledek

1
3
-1
6
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje