CKTIS / JavaScript
String.prototype.search — nájdenie indexu zhody so vzorom
Metóda search() nájde prvú zhodu regulárneho výrazu a vráti jej index alebo -1. Reťazcový argument sa interpretuje ako vzor, nie ako doslovný podreťazec.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
string.search(regexp)String.prototype.search vracia index prvej zhody s bežným RegExp, alebo -1, ak sa žiadna zhoda nenájde. Index sa začína nulou a meria sa v jednotkách kódu UTF-16, nie vo viditeľných znakoch. Metóda reťazec nemení ani nevracia nájdený podreťazec. Výsledok kontrolujte pomocou !== -1: index 0 znamená úspešnú zhodu.
Ak má argument volateľnú metódu [Symbol.search], či už vlastnú alebo zdedenú, search() ju zavolá namiesto vytvorenia nového regulárneho výrazu. Bežné inštancie RegExp dedia túto metódu z RegExp.prototype. Ak je argument null alebo undefined alebo ak čítanie jeho vlastnosti [Symbol.search] vráti null alebo undefined, search() vytvorí z argumentu regulárny výraz. Akákoľvek iná nevolateľná hodnota tejto vlastnosti vyvolá TypeError. Preto "abc".search(".") vráti 0: . zodpovedá ľubovoľnému znaku okrem znaku ukončujúceho riadok, nie doslovnej bodke. Na hľadanie doslovného textu použite indexOf(). Vynechanie argumentu alebo odovzdanie hodnoty undefined vytvorí prázdny vzor a vráti 0.
Pri bežnom RegExp príznak g nezhromažďuje všetky zhody. Hľadanie sa začína s hodnotou lastIndex nastavenou na 0 a po normálnom dokončení sa obnoví jej predchádzajúca hodnota. Príznak y naďalej vyžaduje zhodu na začiatku reťazca. Metóda neprijíma argument určujúci počiatočnú pozíciu.
Používateľom definovaná metóda [Symbol.search] môže úplne určiť správanie vrátane typu výsledku. V príklade sa číslice začínajú na indexe 7, lastIndex zostáva 8 a nenájdená zhoda vráti -1.
Príklady
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("."));Výsledok
7 8 -1 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.