Questa traduzione è incompleta. Collabora alla traduzione di questo articolo dall’originale in lingua inglese.

Il metodo indexOf() restituisce l'indice all'interno dell'oggetto String chiamante della prima occorrenza del valore specificato, avviando il cerca su fromIndex . Restituisce -1 se il valore non viene trovato.

Note: Per il metodo Array, vedere Array.prototype.indexOf().

Sintassi

str.indexOf(searchValue[, fromIndex])

Parameteri

searchValue
Una stringa che rappresenta il valore da cercare.
fromIndex Optional
Un numero intero che rappresenta l'indice al quale avviare la ricerca; il valore predefinito è 0. Per i valori fromIndex inferiori a 0 o maggiori di str.length, la ricerca inizia rispettivamente a index 0 and str.length.

Valore di Ritorno

L'indice della prima occorrenza di searchValue o -1 se non trovato.
Una stringa vuota searchValue corrisponderà a qualsiasi indice compreso tra  0 e str.length

Descrizione

caratteri in una stringa sono indicizzati da sinistra a destra. L'indice del primo carattere è 0 e l'indice dell'ultimo carattere di una stringa chiamato  stringName è stringName.length - 1.

'Blue Whale'.indexOf('Blue');     // returns  0
'Blue Whale'.indexOf('Blute');    // returns -1
'Blue Whale'.indexOf('Whale', 0); // returns  5
'Blue Whale'.indexOf('Whale', 5); // returns  5
'Blue Whale'.indexOf('Whale', 7); // returns -1
'Blue Whale'.indexOf('');         // returns  0
'Blue Whale'.indexOf('', 9);      // returns  9
'Blue Whale'.indexOf('', 10);     // returns 10
'Blue Whale'.indexOf('', 11);     // returns 10

Il metodo indexOf()  è case sensitive. Ad esempio, la seguente espressione restituisce -1:

'Blue Whale'.indexOf('blue'); // returns -1

Checking occurrences

Nota che '0' non valuta il true e '-1' non valuta il false. Pertanto, quando si verifica se una stringa specifica esiste all'interno di un'altra stringa, il modo corretto per verificare sarebbe:

'Blue Whale'.indexOf('Blue') !== -1; // true
'Blue Whale'.indexOf('Bloe') !== -1; // false

Esempi

Usando indexOf()

Nell'esempio seguente viene utilizzato indexOf() per individuare i valori nella stringa "Brave new world".

var str = 'Brave new world';

console.log('Index of first w from start is ' + str.indexOf('w'));  // logs 8
console.log('Index of "new" from start is ' + str.indexOf('new'));  // logs 6

indexOf() e case-sensitivity

The following example defines two string variables. The variables contain the same string except that the second string contains uppercase letters. The first console.log() method displays 19. But because the indexOf() method is case sensitive, the string "cheddar" is not found in myCapString, so the second console.log() method displays -1.

var myString    = 'brie, pepper jack, cheddar';
var myCapString = 'Brie, Pepper Jack, Cheddar';

console.log('myString.indexOf("cheddar") is ' + myString.indexOf('cheddar'));
// logs 19
console.log('myCapString.indexOf("cheddar") is ' + myCapString.indexOf('cheddar'));
// logs -1

Using indexOf() to count occurrences of a letter in a string

The following example sets count to the number of occurrences of the letter e in the string str:

var str = 'To be, or not to be, that is the question.';
var count = 0;
var pos = str.indexOf('e');

while (pos !== -1) {
  count++;
  pos = str.indexOf('e', pos + 1);
}

console.log(count); // displays 4

Specifications

Specification Status Comment
ECMAScript 1st Edition (ECMA-262) Standard Initial definition.
ECMAScript 5.1 (ECMA-262)
The definition of 'String.prototype.indexOf' in that specification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'String.prototype.indexOf' in that specification.
Standard  
ECMAScript Latest Draft (ECMA-262)
The definition of 'String.prototype.indexOf' in that specification.
Draft  

Browser compatibility

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung InternetNode.js
Basic supportChrome Full support YesEdge Full support YesFirefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yesnodejs Full support Yes

Legend

Full support  
Full support

See also

Tag del documento e collaboratori

Hanno collaborato alla realizzazione di questa pagina: ladysilvia
Ultima modifica di: ladysilvia,