Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

RegExp.prototype.test — provjera podudaranja

Metoda test() provjerava podudara li se regularni izraz s tekstom i vraća true ili false. Zastavice g i y uzrokuju da pretraživanje koristi lastIndex pa ponovljeni pozivi mogu dati različite rezultate.

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

Sintaksa

regexp.test(string)

RegExp.prototype.test pozivaš kao regexp.test(string). Vraća true ako pronađe podudaranje, a inače false. Ne vraća uhvaćene grupe; za njihovo dobivanje upotrijebi exec(). Argument se pretvara u tekst. Ako izostaviš argument, postaje tekst "undefined".

Prema zadanim postavkama dovoljno je da se podudara dio teksta. Želiš li podudaranje ograničiti na granice ulaza, upotrijebi sidra ^ i $, uz napomenu da ih zastavica m pretvara u granice redaka.

Uz standardnu implementaciju exec(), zastavice g i y koriste lastIndex za određivanje početnog položaja. Uz g pretraživanje može provjeriti i kasnije položaje, dok uz y ne ide dalje. Ako u načinu rada Unicode (uz u ili v) lastIndex pokazuje na donji surogat surogatnog para UTF-16, podudaranje može početi na prethodnom gornjem surogatu, čak i uz y. Uspjeh postavlja lastIndex na kraj podudaranja, a neuspjeh ga vraća na nulu. Ako nije postavljena nijedna od tih zastavica, standardna implementacija exec() ipak čita lastIndex i primjenjuje operaciju ToLength na njegovu vrijednost. Ako pretvorba uspije, pretraživanje počinje na položaju 0 bez promjene svojstva lastIndex. No ako svojstvu lastIndex dodijeliš vrijednost tipa Symbol, test() baca iznimku TypeError i bez zastavica g i y. Za neovisne provjere izostavi g i y ili postavi lastIndex = 0 prije svakog poziva.

Prazno podudaranje ne pomiče automatski lastIndex: petlja utemeljena na test() možda neće završiti. Metoda koristi exec(), pa njezino nadjačavanje može promijeniti ponašanje. Ovo je API jezika ECMAScript, a ne API preglednika.

Primjeri

const pattern = /cat/g;
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
pattern.lastIndex = 0;
console.log(pattern.test("cat"));

Rezultat

true
3
false
0
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori