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

CKTIS / JavaScript

String.prototype.search — iskanje indeksa ujemanja z vzorcem

Metoda search() poišče prvo ujemanje regularnega izraza in vrne njegov indeks ali -1. Nizovni argument se razume kot vzorec, ne kot dobesedni podniz.

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.search(regexp)

String.prototype.search vrne indeks prvega ujemanja z običajnim RegExp ali -1, če ujemanja ni. Indeks se začne z nič in se meri v kodnih enotah UTF-16, ne v vidnih znakih. Metoda niza ne spremeni in ne vrne najdenega podniza. Rezultat preverite z !== -1: indeks 0 pomeni uspešno ujemanje.

Če ima argument klicljivo metodo [Symbol.search], lastno ali podedovano, jo search() pokliče, namesto da bi ustvaril nov regularni izraz. Običajni primerki RegExp to metodo podedujejo od RegExp.prototype. Če je argument null ali undefined ali če dostop do njegove lastnosti [Symbol.search] vrne null ali undefined, search() iz argumenta ustvari regularni izraz. Vsaka druga neklicljiva vrednost te lastnosti povzroči napako TypeError. Zato "abc".search(".") vrne 0: . se ujema s katerim koli znakom, razen z znakom za konec vrstice, ne pa z dobesedno piko. Za iskanje dobesednega besedila uporabite indexOf(). Če argument izpustite ali podate undefined, nastane prazen vzorec, rezultat pa je 0.

Pri običajnem RegExp zastavica g ne zbere vseh ujemanj. Iskanje se začne z lastIndex, nastavljenim na 0, po običajnem zaključku pa se njegova prejšnja vrednost obnovi. Zastavica y še vedno zahteva ujemanje na začetku niza. Metoda ne sprejema argumenta za začetni položaj.

Metoda [Symbol.search] po meri lahko v celoti določi vedenje, vključno z vrsto rezultata. V primeru se števke začnejo pri indeksu 7, lastIndex ostane 8, neuspešno iskanje pa vrne -1.

Primeri

const text = "Order: 42";
const pattern = /\d+/g;
pattern.lastIndex = 8;

console.log(text.search(pattern));
console.log(pattern.lastIndex);
console.log(text.search(/missing/));
console.log("abc".search("."));

Rezultat

7
8
-1
0

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

Viri