Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.prototype.lastIndexOf — dernière occurrence d’une sous-chaîne

lastIndexOf() renvoie l’indice de la dernière occurrence d’une sous-chaîne, ou -1. L’argument facultatif position limite l’endroit où une correspondance commence, et non celui où elle se termine.

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

Syntaxe

str.lastIndexOf(searchString[, position])

String.prototype.lastIndexOf effectue une recherche de sous-chaîne sensible à la casse et renvoie le plus grand indice correspondant, à partir de zéro, ou -1. La méthode ne modifie pas la chaîne. Les indices comptent les unités de code UTF-16, qui ne correspondent pas nécessairement à des caractères complets tels que les perçoit l’utilisateur.

L’argument facultatif position définit l’indice de départ maximal autorisé pour une correspondance ; celle-ci peut se terminer au-delà. Si l’argument est omis, ou si undefined ou NaN est transmis, toute la chaîne peut être parcourue. Les valeurs fractionnaires sont tronquées vers zéro, les valeurs négatives sont ramenées à 0, et les valeurs trop grandes n’étendent pas la recherche au-delà de la chaîne. Ainsi, un position négatif peut tout de même trouver une correspondance commençant à 0.

Une searchString vide correspond à chaque frontière entre unités de code ; sans position, le résultat est la longueur de la chaîne. searchString est convertie en chaîne : si elle est omise, la recherche porte sur "undefined". La méthode n’interprète pas les expressions régulières.

Dans l’exemple, "ana" commence aux indices 1 et 3. Utilisez !== -1 pour vérifier la présence : l’indice 0 est un résultat valide, même s’il est falsy dans une condition.

Exemples

const text = "banana";
console.log(text.lastIndexOf("ana"));
console.log(text.lastIndexOf("ana", 2));
console.log(text.lastIndexOf("x"));
console.log(text.lastIndexOf(""));
console.log(text.lastIndexOf("b", -1));

Résultat

3
1
-1
6
0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources