Manuel de référence JavaScript RegExp

Objet RegExp

Une expression régulière est un modèle de caractères.

Ce modèle est utilisé pour la fonction de recherche et de remplacement de modèle de texte.

En JavaScript, l'objet RegExp est un objet qui possède des propriétés et des méthodes.

Syntaxe

/pattern/modifier(s);

Exemple

let pattern = /codew3c/i;

Essayez-le vous-même

Explication des exemples :

codew3c Modèle à rechercher
/codew3c/ Expression régulière
/codew3c/i Expression régulière sans distinction de cas

Pour en savoir plus sur les expressions régulières, veuillez lire notre Tutoriel RegExp JavaScript.

Modificateur

Les modificateurs sont utilisés pour effectuer une recherche sans distinction de cas et globale :

Modificateur Description
g Effectuer une correspondance globale (recherche de toutes les correspondances au lieu de s'arrêter après la première correspondance).
i Effectuer une correspondance sans distinction de cas.
d Effectuer une correspondance de sous-chaîne.
m Effectuer une correspondance de plusieurs lignes.

Crochets

Les crochets sont utilisés pour rechercher les caractères dans une plage donnée :

Expression Description
[abc] Recherche de tout caractère entre les parenthèses.
[^abc] Recherche de tout caractère qui n'est pas entre crochets.
[0-9] Recherche de tout nombre entre 0 et 9.
[^0-9] Recherche de tout caractère qui n'est pas entre les parenthèses (tout caractère non numérique).
(x|y) Recherche de toute option spécifiée.

Caractères de métacaractère

Les caractères de métacaractère sont des caractères ayant un sens spécial :

Caractères de métacaractère Description
. Recherche d'un seul caractère, sauf le retour chariot ou le terminateur de ligne.
\w Recherche des caractères mot.
\W Recherche des caractères non mot.
\d Recherche des chiffres.
\D Recherche des caractères non numériques.
\s Recherche des caractères blancs.
\S Recherche des caractères non blancs.
\b Recherche du match au début ou à la fin du mot, le début est comme suit : \bHI, la fin est comme suit : HI\b.
\B Recherche du match, mais pas au début ou à la fin du mot.
\0 Recherche du caractère NULL.
\n Recherche du retour chariot.
\f Recherche du saut de page.
\r Recherche du retour chariot.
\t Recherche du tabulation.
\v Recherche du tabulation verticale.
\xxx Recherche du caractère spécifié par le nombre octal xxx.
\xdd Recherche du caractère spécifié par le nombre hexadécimal dd.
\udddd Recherche du caractère Unicode spécifié par le nombre hexadécimal xxxx.

Quantificateurs

Quantificateurs Description
n+ Matche n'importe quelle chaîne de caractères contenant au moins un n.
n* Matche n'importe quelle chaîne de caractères contenant zéro ou plusieurs n.
n? Matche n'importe quelle chaîne de caractères contenant zéro ou un n.
n{X} Matche n'importe quelle séquence de caractères contenant X n.
n{X,Y} Matche n'importe quelle séquence de caractères contenant entre X et Y n.
n{X,} Matche n'importe quelle séquence de caractères contenant au moins X n.
n$ Matche n'importe quelle chaîne de caractères qui se termine par n.
^n Matche n'importe quelle chaîne de caractères qui commence par n.
?=n Matche n'importe quelle chaîne de caractères qui suit immédiatement la chaîne spécifiée n.
?!n Matche n'importe quelle chaîne de caractères qui ne suit pas immédiatement la chaîne spécifiée n.

Propriétés de l'objet RegExp

Propriétés Description
constructor Retourne la fonction qui crée l'original de l'objet RegExp.
global Vérifie si le modificateur "g" est défini.
ignoreCase Vérifie si le modificateur "i" est défini.
lastIndex Définit l'index de début pour le prochain match.
multiline Vérifie si le modificateur "m" est défini.
source Retourne le texte du motif RegExp.

Méthodes de l'objet RegExp

Méthode Description
compile() Déprécié depuis la version 1.5. Compile l'expression régulière.
exec() Tester les éléments correspondants dans une chaîne de caractères. Retourne le premier élément correspondant.
test() Tester les éléments correspondants dans une chaîne de caractères. Retourne true ou false.
toString() 

patternattributes

pattern attributes

Paramètres

Paramètres pattern C'est une chaîne, spécifiant le schéma de l'expression régulière ou une autre expression régulière.

Paramètres attributes C'est une chaîne optionnelle, contenant les attributs "g", "i" et "m", respectivement utilisés pour spécifier la correspondance globale, la correspondance en tenant compte de la casse et la correspondance sur plusieurs lignes. Avant la standardisation de l'ECMAScript, l'attribut m n'était pas pris en charge. Si pattern Est une expression régulière plutôt qu'une chaîne, il faut omettre ce paramètre.

Valeur de retour

Un nouveau objet RegExp, avec le schéma et les attributs spécifiés. pattern C'est une expression régulière plutôt qu'une chaîne, le constructeur RegExp() crée un nouveau objet RegExp avec le même schéma et les mêmes attributs que l'expression RegExp spécifiée.

Si vous ne utilisez pas l'opérateur new, mais que vous appellez RegExp() comme une fonction, son comportement est le même que lorsqu'il est appelé avec l'opérateur new, mais quand pattern C'est une expression régulière, il ne retourne que patternEt ne crée plus un nouveau objet RegExp.

Lève

SyntaxError - Si pattern N'est pas une expression régulière légitime ou attributes Contient des caractères autres que "g", "i" et "m", lève cette exception.

TypeError - Si pattern C'est un objet RegExp, mais sans omission attributes Paramètres, lève cette exception.

Support du navigateur

/regexp/ est une caractéristique de ECMAScript1 (ES1).

Tous les navigateurs supportent complètement ES1 (JavaScript 1997) :

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Supporte Supporte Supporte Supporte Supporte Supporte

Méthodes de l'objet String supportant les expressions régulières

Méthode Description
search Récupérer les valeurs correspondant à l'expression régulière.
match Trouver une ou plusieurs correspondances d'expressions régulières.
replace Remplacer la sous-chaîne correspondant à l'expression régulière.
split Diviser une chaîne en tableau de chaînes.