Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

String.prototype.search — trovare l’indice di una corrispondenza

Il metodo search() trova la prima corrispondenza di un’espressione regolare e ne restituisce l’indice oppure -1. Un argomento stringa viene interpretato come un pattern, non come una sottostringa letterale.

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

string.search(regexp)

String.prototype.search restituisce l’indice della prima corrispondenza di un RegExp ordinario, oppure -1 se non ce ne sono. L’indice parte da zero ed è misurato in unità di codice UTF-16, non in caratteri visibili. Il metodo non modifica la stringa e non restituisce la sottostringa corrispondente. Verifica il risultato con !== -1: l’indice 0 indica una corrispondenza riuscita.

Se l’argomento ha un metodo [Symbol.search] invocabile, proprio o ereditato, search() lo chiama anziché creare una nuova espressione regolare. Le normali istanze di RegExp ereditano questo metodo da RegExp.prototype. Se l’argomento è null o undefined, oppure se l’accesso alla sua proprietà [Symbol.search] restituisce null o undefined, search() crea un’espressione regolare a partire dall’argomento. Qualsiasi altro valore non invocabile di quella proprietà provoca un TypeError. Di conseguenza, "abc".search(".") restituisce 0: . corrisponde a qualsiasi carattere tranne un terminatore di riga, non a un punto letterale. Usa indexOf() per cercare testo letterale. Omettere l’argomento o passare undefined crea un pattern vuoto e produce 0.

Con un RegExp ordinario, il flag g non raccoglie tutte le corrispondenze. La ricerca inizia con lastIndex impostato su 0 e, al termine normale, il valore precedente viene ripristinato. Il flag y richiede comunque una corrispondenza all’inizio della stringa. Il metodo non accetta un argomento che specifichi la posizione iniziale.

Un metodo [Symbol.search] personalizzato può definire interamente il comportamento, compreso il tipo del risultato. Nell’esempio, le cifre iniziano all’indice 7, lastIndex rimane 8 e l’assenza di una corrispondenza produce -1.

Esempi

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

Risultato

7
8
-1
0

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