String.prototype.lastIndexOf()

La méthode lastIndexOf() renvoie l'indice, dans la chaîne courante, de la dernière occurence de la valeur donnée en argument. Si cette sous-chaîne n'est pas trouvée, la méthode renvoie -1. La recherche s'effectue de la fin vers le début de la chaîne, à partir de indiceDébut.

Syntaxe

str.lastIndexOf(valeurRecherchée[, indiceDébut])

Paramètres

valeurRecherchée
Une chaîne qu'on recherche dans la chaîne courante. Si ce paramètre n'est pas défini et que indiceDébut est utilisé, c'est ce dernier qui sera renvoyé par la fonction.
indiceDébut Facultatif
Paramètre optionnel. L'emplacement, dans la chaîne courante, à partir duquel effectuer la recherche (en partant de la fin de la chaîne et en remontant vers le début). Cela peut être n'importe quel entier. La valeur par défaut est =Infinity. Si indiceDébut > str.length, toute la chaîne sera parcourue. Si indiceDébut < 0,  on aura le même comportement que si indiceDébut valait 0.

Valeur de retour

L'indice de la dernière occurrence de la valeur indiquée, -1 si elle n'est pas trouvée.

Description

Les caractères d'une chaîne de caractères sont indexés de gauche à droite. L'indice du premier caractère vaut 0 et l'indice du dernier caractère vaut maChaîne.length - 1.

'canal'.lastIndexOf('a');     // renvoie 3
'canal'.lastIndexOf('a', 2);  // renvoie 1
'canal'.lastIndexOf('a', 0);  // renvoie -1
'canal'.lastIndexOf('x');     // renvoie -1
'canal'.lastIndexOf('c', -1); // renvoie 0 comme lastIndexOf('c',0)

Sensibilité à la casse

La méthode lastIndexOf() est sensible à la casse. Ainsi, le résultat de l'expression suivante sera -1 :

'Blue Whale, Killer Whale'.lastIndexOf('blue'); // renvoie -1

Exemples

Utiliser indexOf() et lastIndexOf()

Dans l'exemple suivant, on utilise indexOf() et lastIndexOf() pour situer certaines valeurs dans la chaîne "Brave new world".

var maChaîne = 'Brave new world';

console.log('Indice du premier w ' + maChaîne.indexOf('w'));
// Affiche 8
console.log('Indice du dernier w ' + maChaîne.lastIndexOf('w')); 
// Affiche 10

console.log('Indice du premier "new" ' + maChaîne.indexOf('new'));
// Affiche 6
console.log('Indice du dernier "new" ' + maChaîne.lastIndexOf('new'));
// Affiche 6

Spécifications

Spécification État Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale.
ECMAScript 5.1 (ECMA-262)
La définition de 'String.prototype.lastIndexOf' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'String.prototype.lastIndexOf' dans cette spécification.
Standard  
ECMAScript 2017 Draft (ECMA-262)
La définition de 'String.prototype.lastIndexOf' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, teoli, tregagnon
 Dernière mise à jour par : SphinxKnight,