[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/String/search [Back]  [Original]

String.prototype.search() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

String.prototype.search()

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La mthode search() xecute une recherche dans une chaine de caractres grce une expression rationnelle applique sur la chane courante.

Dans cet article

Exemple interactif

const paragraph = "I think Ruth's dog is cuter than your dog!";

// Anything not a word character, whitespace or apostrophe
const regex = /[^\w\s']/g;

console.log(paragraph.search(regex));
// Expected output: 41

console.log(paragraph[paragraph.search(regex)]);
// Expected output: "!"

Syntaxe

js
str.search(regexp);

Paramtres

regexp

Un objet reprsentant une expression rationnelle. Si l'objet pass n'est pas un objet d'expression rgulire, il est directement converti en une instance de RegExp en utilisant new RegExp(obj).

Valeur de retour

Si la recherche aboutit, search() renvoie un entier qui correspond l'indice de la premire correspondance trouve dans la chane. Si rien n'est trouv, la mthode renvoie -1.

Description

Si la recherche est positive, search() renvoie l'indice de la premire correspondance pour l'expression rationnelle au sein de la chaine de caractres. Sinon, la mthode renvoie -1.

Si on souhaite savoir si un motif est trouv dans une chaine de caractres, on utilisera cette mthode (semblable la mthode test()) du prototype de RegExp ; pour plus d'informations (mais une xecution plus lente), on utilisera match() (semblable la mthode exec() pour les expressions rationnelles). La mthode test est semblable mais renvoie uniquement un boolen indiquant si une correspondance a t trouve.

Exemples

Dans l'exemple suivant, on utilise une chane de caractres pour laquelle on applique deux expressions rationnelles (la premire permet d'obtenir une correspondance et la seconde n'en trouve aucune).

js
var maChaine = "CoucOu";
var regex1 = /[A-Z]/g;
var regex2 = /[.]/g;

console.log(maChaine.search(regex1)); // Renvoie 0, la position de la premire majuscule
console.log(maChaine.search(regex2)); // Renvoie -1 car il n'y a aucun point dans la chane

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-string.prototype.search

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page