CKTIS / JavaScript
String.prototype.indexOf — trovare una sottostringa
String.prototype.indexOf restituisce l’indice della prima occorrenza di una sottostringa a partire dalla posizione ottenuta convertendo e limitando position, oppure -1 se non trova corrispondenze. Distingue tra maiuscole e minuscole e misura gli indici in unità di codice UTF-16.
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.indexOf(searchString)
string.indexOf(searchString, position)String.prototype.indexOf cerca una sottostringa letterale senza modificare il testo. La ricerca inizia dalla posizione ottenuta convertendo e limitando position. Il metodo restituisce l’indice della prima corrispondenza, oppure -1 se non ne trova nessuna. Gli indici partono da 0 e rappresentano unità di codice UTF-16, che non corrispondono necessariamente a caratteri visibili completi. La ricerca distingue tra maiuscole e minuscole.
L’argomento facoltativo position ha valore predefinito 0. Viene convertito in un intero troncando la parte frazionaria verso zero e poi limitato all’intervallo da 0 alla lunghezza del testo. NaN significa 0. Se la conversione di position riesce e searchString è una stringa vuota, il metodo restituisce la posizione così ottenuta, anche se si trova alla fine del testo. Passare 0n come valore di position fa sì che il metodo sollevi un’eccezione TypeError prima di iniziare la ricerca.
searchString viene convertito in una stringa; se l’argomento è omesso, la ricerca riguarda "undefined". Il metodo non interpreta le espressioni regolari: anche un oggetto RegExp fornito viene convertito in una stringa.
Verifica la presenza della sottostringa con result !== -1, non con if (result): l’indice 0 è falsy, mentre -1 è truthy. Nell’esempio, position cambia il punto da cui inizia la ricerca, ma l’indice restituito si riferisce comunque all’intero testo.
Esempi
const text = "banana";
console.log(text.indexOf("ana"));
console.log(text.indexOf("ana", 2));
console.log(text.indexOf("B"));
console.log(text.indexOf("", 99));
console.log(text.indexOf("ban") !== -1);Risultato
1 3 -1 6 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.