Baseline Widely available
Le constructeur RegExp crée une expression rationnelle pour manipuler les correspondances trouvées dans un texte par rapport à un motif.
Pour une introduction au sujet des expressions rationnelles, nous vous conseillons de lire le chapitre sur les expressions rationnelles du Guide JavaScript.
Exemple interactifconst regex1 = /\w+/;
const regex2 = new RegExp("\\w+");
console.log(regex1);
// Expected output: /\w+/
console.log(regex2);
// Expected output: /\w+/
console.log(regex1 === regex2);
// Expected output: false
Il est possible d'utiliser des syntaxes littérales, d'utiliser un constructeur ou la fonction directement :
/motif/marqueurs
new RegExp(motif[, marqueurs])
RegExp(motif[, marqueurs])
motif
Le texte de l'expression rationnelle.
Avec ES5, ce peut être un autre objet RegExp ou une valeur littérale (uniquement lorsqu'on utilise la notation avec la fonction / le constructeur). Un motif peut contenir des caractères spéciaux pour cibler un ensemble plus large de valeurs que ce que permet une chaîne de caractère littérale.
marqueurs
Si cet argument est utilisé, c'est une chaîne de caractères qui contient les marqueurs à ajouter à l'expression rationnelle.
Si c'est un objet qui est fourni pour le motif, les marqueurs fournis par ce deuxième paramètre remplaceront les marqueurs provenant de l'objet (et lastIndex sera réinitialisé à 0) (ES2015).
Si marqueurs n'est pas indiqué comme argument et que le premier paramètre est un objet représentant une expression rationnelle, les marqueurs de ce dernier (y compris lastIndex) seront recopiés sur la nouvelle instance.
marqueurs peut contenir toute combinaison avec les caractères suivants :
d (indices)
Génère les indices des positions pour les sous-chaînes correspondantes.
g (recherche globale)
Trouve l'ensemble des correspondances plutôt que de s'arrêter à la première.
i (sensibilité à la casse)
Si le marqueur u est également activé, active le repliage de casse Unicode (case folding).
m (multiligne)
Les caractères (^ et $) fonctionnent sur plusieurs lignes. Autrement dit, ils correspondent aux débuts et aux fins de chaque ligne (délimitées par \n ou \r) et pas uniquement au début ou à la fin de la chaîne de caractère étudiée.
s ("dotAll")
Permet à . de correspondre à des nouvelles lignes.
u (unicode)
Traite motif comme une séquence de codets Unicode (voir aussi les chaînes de caractères binaires).
y (adhérence)
Ne cherche les correspondances dans la chaîne cible qu'à partir de l'indice porté par la propriété lastIndex de l'expression rationnelle. N'effectue pas de recherche sur des indices antérieurs.
motif ne peut être interprété comme une expression rationnelle valide, une exception SyntaxError sera levée.marqueurs contient des caractères répétés ou en dehors de ceux autorisés, une exception SyntaxError sera levée.Il existe deux façons de créer un objet RegExp : en utilisant une notation littérale ou un constructeur.
Les trois expressions suivantes permettent de créer la même expression rationnelle :
/ab+c/i;
new RegExp(/ab+c/, "i"); // Notation littérale
new RegExp("ab+c", "i"); // Constructeur
La notation littérale provoque la compilation de l'expression rationnelle lorsque l'expression est évaluée. On utilisera la notation littérale lorsque l'expression rationnelle demeure constante. Ainsi, si on utilise une notation littérale pour construire une expression rationnelle utilisée dans une boucle, l'expression rationnelle ne sera pas recompilée à chaque itération.
L'utilisation du constructeur (new RegExp('ab+c')) causera une compilation à l'exécution pour l'expression rationnelle. On utilisera le constructeur lorsqu'on sait que le motif changera ou qu'on ne connait pas, par avance le motif (par exemple s'il provient d'autre source).
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4