RegExp : méthode compile()
Obsolète
Évitez d'utiliser cette fonctionnalité dans de nouveaux projets.
The compile() method duplicates behavior of the RegExp() constructor and it exists only for backwards compatibility.
Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.
Note :
La méthode compile() n'est définie que pour des raisons de compatibilité. L'utilisation de compile() rend la source et les indicateurs de l'expression rationnelle, autrement immuables, mutables, ce qui peut perturber les attentes de l'utilisateur·ice. Vous pouvez utiliser le constructeur RegExp() pour créer un nouvel objet expression rationnelle à la place.
La méthode compile() des instances de RegExp est utilisée pour recompiler une expression rationnelle avec une nouvelle source et de nouveaux indicateurs après que l'objet RegExp a déjà été créé.
Syntaxe
compile(pattern, flags)
Paramètres
pattern-
Le texte de l'expression rationnelle.
flags-
Toute combinaison des valeurs d'indicateurs.
Valeur de retour
Aucune (undefined).
Exceptions
TypeError-
Lève une exception si la valeur de
thisn'est pas une instance du constructeurRegExpdu domaine actuel. Cela inclut une sous-classe deRegExpet le constructeurRegExpd'un domaine différent.
Exemples
Utiliser compile()
L'exemple suivant montre comment recompiler une expression rationnelle avec un nouveau motif et un nouvel indicateur.
const regexObj = /toto/gi;
regexObj.compile("nouveau toto", "g");
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Language Specification # sec-regexp.prototype.compile |
Compatibilité des navigateurs
Voir aussi
- L'objet natif
RegExp