Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

String.prototype.indexOf — iskanje podniza

String.prototype.indexOf vrne indeks prve pojavitve podniza od položaja, dobljenega s pretvorbo in omejitvijo vrednosti position, ali -1, če ujemanja ni. Razlikuje med velikimi in malimi črkami, indeksi pa so izraženi v kodnih enotah UTF-16.

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

Sintaksa

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

String.prototype.indexOf išče dobesedni podniz, ne da bi spremenil besedilo. Iskanje se začne na položaju, dobljenem s pretvorbo in omejitvijo vrednosti position. Metoda vrne indeks prvega ujemanja oziroma -1, če ujemanja ni. Indeksi se začnejo pri 0 in predstavljajo kodne enote UTF-16, ne nujno celotnih vidnih znakov. Iskanje razlikuje med velikimi in malimi črkami.

Izbirni argument position ima privzeto vrednost 0. Pretvori se v celo število tako, da se decimalni del odreže proti nič, nato pa se omeji na razpon od 0 do dolžine besedila. NaN pomeni 0. Če je pretvorba vrednosti position uspešna in je searchString prazen niz, metoda vrne tako dobljeni položaj, tudi če je na koncu besedila. Če kot vrednost argumenta position podate 0n, metoda sproži izjemo TypeError še pred začetkom iskanja.

searchString se pretvori v niz; če argument izpustite, se išče "undefined". Metoda ne obravnava regularnih izrazov: tudi podani objekt RegExp se pretvori v niz.

Prisotnost podniza preverite z result !== -1, ne z if (result): indeks 0 je falsy, medtem ko je -1 truthy. V primeru position spremeni začetek iskanja, vendar se vrnjeni indeks še vedno nanaša na celotno besedilo.

Primeri

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

Rezultat

1
3
-1
6
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri