CKTIS / JavaScript
String.prototype.search — trouver l’index d’une correspondance
La méthode search() trouve la première correspondance d’une expression régulière et renvoie son index ou -1. Un argument de type chaîne est interprété comme un motif, et non comme une sous-chaîne littérale.
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.search(regexp)String.prototype.search renvoie l’index de la première correspondance d’un RegExp ordinaire, ou -1 s’il n’y en a pas. L’index commence à zéro et se mesure en unités de code UTF-16, et non en caractères visibles. La méthode ne modifie pas la chaîne et ne renvoie pas la sous-chaîne trouvée. Vérifiez le résultat avec !== -1 : l’index 0 indique une correspondance réussie.
Si l’argument possède une méthode [Symbol.search] appelable, propre ou héritée, search() l’appelle au lieu de créer une nouvelle expression régulière. Les instances ordinaires de RegExp héritent de cette méthode de RegExp.prototype. Si l’argument vaut null ou undefined, ou si l’accès à sa propriété [Symbol.search] donne null ou undefined, search() crée une expression régulière à partir de l’argument. Toute autre valeur non appelable de cette propriété provoque une exception TypeError. Ainsi, "abc".search(".") renvoie 0 : . correspond à n’importe quel caractère sauf un terminateur de ligne, et non à un point littéral. Utilisez indexOf() pour rechercher du texte littéral. Omettre l’argument ou transmettre undefined crée un motif vide et renvoie 0.
Avec un RegExp ordinaire, le drapeau g ne recueille pas toutes les correspondances. La recherche commence avec lastIndex égal à 0, puis sa valeur précédente est rétablie à la fin normale de l’opération. Le drapeau y exige toujours une correspondance au début de la chaîne. La méthode n’accepte aucun argument indiquant une position de départ.
Une méthode [Symbol.search] personnalisée peut définir entièrement le comportement, y compris le type du résultat. Dans l’exemple, les chiffres commencent à l’index 7, lastIndex reste égal à 8, et l’absence de correspondance renvoie -1.
Exemples
const text = "Order: 42";
const pattern = /\d+/g;
pattern.lastIndex = 8;
console.log(text.search(pattern));
console.log(pattern.lastIndex);
console.log(text.search(/missing/));
console.log("abc".search("."));Résultat
7 8 -1 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.