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

CKTIS / JavaScript

String.prototype.search — nalezení indexu shody se vzorem

Metoda search() najde první shodu regulárního výrazu a vrátí její index, nebo -1. Řetězcový argument se interpretuje jako vzor, nikoli jako doslovný podřetězec.

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

String.prototype.search vrací index první shody s běžným RegExp, nebo -1, pokud žádná shoda neexistuje. Index začíná nulou a měří se v jednotkách kódu UTF-16, nikoli ve viditelných znacích. Metoda řetězec nemění ani nevrací nalezený podřetězec. Výsledek ověřujte pomocí !== -1: index 0 znamená úspěšnou shodu.

Pokud má argument volatelnou metodu [Symbol.search], ať už vlastní, nebo zděděnou, search() ji zavolá namísto vytvoření nového regulárního výrazu. Běžné instance RegExp tuto metodu dědí z RegExp.prototype. Pokud je argument null nebo undefined nebo pokud čtení jeho vlastnosti [Symbol.search] vrátí null nebo undefined, search() vytvoří z argumentu regulární výraz. Jakákoli jiná nevolatelná hodnota této vlastnosti vyvolá TypeError. Proto "abc".search(".") vrátí 0: . odpovídá libovolnému znaku kromě znaku ukončujícího řádek, nikoli doslovné tečce. Pro hledání doslovného textu použijte indexOf(). Vynechání argumentu nebo předání hodnoty undefined vytvoří prázdný vzor a vrátí 0.

U běžného RegExp příznak g neshromažďuje všechny shody. Hledání začíná s hodnotou lastIndex nastavenou na 0 a po normálním dokončení se obnoví její předchozí hodnota. Příznak y stále vyžaduje shodu na začátku řetězce. Metoda nepřijímá argument určující počáteční pozici.

Uživatelsky definovaná metoda [Symbol.search] může zcela určit chování včetně typu výsledku. V příkladu začínají číslice na indexu 7, lastIndex zůstává 8 a nenalezená shoda vrátí -1.

Pří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ýsledek

7
8
-1
0

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