Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

RegExp.prototype.test — verificare la presenza di una corrispondenza

Il metodo test() verifica se un’espressione regolare corrisponde a un testo e restituisce true o false. I flag g e y fanno usare lastIndex per la ricerca, quindi chiamate ripetute possono dare risultati diversi.

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

Sintassi

regexp.test(string)

Chiama RegExp.prototype.test come regexp.test(string). Restituisce true se trova una corrispondenza e false altrimenti. Non restituisce i gruppi acquisiti; per ottenerli, usa exec(). L’argomento viene convertito in testo. Se l’argomento è omesso, diventa il testo "undefined".

Per impostazione predefinita, è sufficiente che corrisponda una parte del testo. Per limitare la corrispondenza ai confini dell’input, usa gli ancoraggi ^ e $, ricordando che il flag m li trasforma in confini di riga.

Con l’implementazione standard di exec(), i flag g e y usano lastIndex per determinare la posizione iniziale. Con g la ricerca può provare posizioni successive, mentre con y non può avanzare. In modalità Unicode (con u o v), se lastIndex punta al surrogato basso di una coppia di surrogati UTF-16, una corrispondenza può iniziare dal surrogato alto che lo precede, anche con y. In caso di successo, lastIndex viene impostato alla fine della corrispondenza; in caso di insuccesso, viene azzerato. Se non è presente nessuno dei due flag, l’implementazione standard di exec() legge comunque lastIndex e applica ToLength al suo valore. Se la conversione riesce, la ricerca parte dalla posizione 0 senza modificare la proprietà lastIndex. Se però assegni a lastIndex un valore di tipo Symbol, test() lancia un’eccezione TypeError anche senza g o y. Per verifiche indipendenti, ometti g e y oppure imposta lastIndex = 0 prima di ogni chiamata.

Una corrispondenza vuota non fa avanzare automaticamente lastIndex: un ciclo basato su test() potrebbe non terminare. Il metodo usa exec(), quindi sovrascriverlo può cambiare il comportamento. Questa è un’API del linguaggio ECMAScript, non un’API del browser.

Esempi

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

Risultato

true
3
false
0
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti