Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

RegExp.prototype.flags — lire les indicateurs d’une expression régulière

La propriété flags renvoie les indicateurs d’une expression régulière sous forme de chaîne, dans un ordre fixe, quelle que soit leur ordre lors de la création. C’est un accesseur sans setter, et non une méthode.

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

regexp.flags

RegExp.prototype.flags est une propriété accesseur qui se lit avec regexp.flags, sans parenthèses d’appel. Elle renvoie une chaîne contenant les indicateurs activés ; s’il n’y en a aucun, le résultat est la chaîne vide "". Elle ne renvoie ni le motif ni les barres obliques qui l’entourent.

Les lettres sont renvoyées dans l’ordre fixe dgimsuvy, les indicateurs désactivés étant omis, et non dans leur ordre d’écriture. Le getter lit successivement les propriétés hasIndices, global, ignoreCase, multiline, dotAll, unicode, unicodeSets et sticky, correspondant à ces lettres. Les valeurs lues sont converties en valeurs booléennes. La prise en charge de flags ne garantit pas celle de chaque indicateur plus récent dans un moteur donné.

L’accesseur n’a pas de setter : affecter une valeur à regexp.flags ne modifie pas les indicateurs de l’expression ; avec une instance ordinaire en mode strict, cela déclenche une TypeError. Pour utiliser d’autres indicateurs, créez une nouvelle expression, par exemple new RegExp(regexp.source, "g"). Le getter lit des propriétés publiques : leur redéfinition peut donc modifier le résultat affiché sans changer le comportement de correspondance.

L’exemple montre la normalisation de l’ordre : /cat/mi renvoie im. JSON.stringify rend visible sous la forme "" la chaîne vide renvoyée pour /cat/.

Exemples

const regexp = /cat/mi;
console.log(regexp.flags);
console.log(JSON.stringify(/cat/.flags));

Résultat

im
""

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.

Sources