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

CKTIS / JavaScript

String.prototype.indexOf — rechercher une sous-chaîne

String.prototype.indexOf renvoie l’index de la première occurrence d’une sous-chaîne à partir de la position obtenue après conversion et bornage de position, ou -1 en l’absence de correspondance. La recherche distingue les majuscules et les minuscules, et les index sont comptés en unités de code UTF-16.

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

string.indexOf(searchString)
string.indexOf(searchString, position)

String.prototype.indexOf recherche une sous-chaîne littérale sans modifier le texte. La recherche commence à la position obtenue après conversion et bornage de position. La méthode renvoie l’index de la première occurrence, ou -1 en l’absence de correspondance. Les index commencent à 0 et représentent des unités de code UTF-16, pas nécessairement des caractères visibles complets. La recherche distingue les majuscules et les minuscules.

L’argument facultatif position vaut 0 par défaut. Il est converti en entier en tronquant sa partie décimale vers zéro, puis limité à l’intervalle allant de 0 à la longueur du texte. NaN signifie 0. Si la conversion de position réussit et que searchString est une chaîne vide, la méthode renvoie la position ainsi obtenue, même si elle se trouve à la fin du texte. Passer 0n comme valeur de position déclenche une exception TypeError avant le début de la recherche.

searchString est converti en chaîne ; si l’argument est omis, la recherche porte sur "undefined". La méthode n’interprète pas les expressions régulières : un objet RegExp fourni est lui aussi converti en chaîne.

Vérifiez la présence de la sous-chaîne avec result !== -1, et non avec if (result) : l’index 0 est falsy, tandis que -1 est truthy. Dans l’exemple, position modifie le début de la recherche, mais l’index renvoyé se rapporte toujours à l’ensemble du texte.

Exemples

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);

Résultat

1
3
-1
6
true

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