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

CKTIS / JavaScript

Indicateurs d’expression régulière : dotAll (`s`), `u`, `i` et `g`

Les indicateurs `s`, `u`, `i` et `g` règlent respectivement le comportement du point face aux sauts de ligne, le mode Unicode, la casse et la recherche globale.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

/pattern/gsui
new RegExp("pattern", "gsui")
re.dotAll; re.unicode; re.ignoreCase; re.global; re.lastIndex

Placez les indicateurs après la barre oblique fermante d’un littéral (/a.b/gsui) ou dans le deuxième argument du constructeur (new RegExp("a.b", "gsui")). Leur ordre ne compte pas ; un indicateur inconnu ou répété provoque une SyntaxError. Les propriétés dotAll, unicode, ignoreCase et global indiquent si s, u, i et g sont activés ; elles ne les modifient pas. Ces règles s’appliquent dans ECMAScript 2024, mais leur prise en charge varie selon l’environnement d’exécution.

Avec s (dotAll), le point générique . reconnaît aussi les quatre caractères de fin de ligne : \n, \r, U+2028 et U+2029. Cela ne change pas les ancres ^ et $ ; c’est m qui leur permet de reconnaître aussi les limites de ligne. Le point échappé \. reste littéral.

u active le mode Unicode : le point traite une paire de substituts valide comme 😄 comme un seul point de code et non comme deux unités UTF-16. Un point de code ne forme pas forcément un graphème entier, c’est-à-dire un caractère perçu comme une unité. u impose aussi une syntaxe plus stricte et ne peut pas être combiné avec v (SyntaxError). i ignore la casse ; associé à u, il applique le repli de casse simple d’Unicode, indépendant des paramètres régionaux, sans transformer ß en ss.

g permet de parcourir les correspondances sans chevauchement. Avec g et sans y, la méthode native exec() utilise lastIndex comme indice en unités UTF-16 pour déterminer où commencer la recherche. En mode Unicode, si cet indice tombe à l’intérieur d’une paire de substituts valide, une correspondance peut commencer au début de cette paire, avant lastIndex. En cas de succès, exec() stocke dans lastIndex l’indice de fin de la correspondance en unités UTF-16 ; en cas d’échec, il le remet à 0. test() peut aussi modifier cet état : pour une recherche indépendante, réinitialisez lastIndex ou créez un nouvel objet RegExp. Une correspondance vide peut bloquer une boucle avec exec(). Pour un argument RegExp, String.prototype.matchAll() exige g (sinon TypeError), avance après les correspondances vides et parcourt les correspondances à l’aide d’une copie dont le lastIndex est initialisé à la valeur courante de celui de l’original.

Exemples

{
  const text = "a\nb A😄b";
  const re = /a.b/gsui;
  const collect = (pattern) => Array.from(text.matchAll(pattern), (m) => m[0]);

  console.log(JSON.stringify(collect(re)));
  console.log(JSON.stringify([/a.b/gui, /a.b/gsi, /a.b/gsu].map(collect)));

  const positions = [];
  for (let n = 0; n < 3; n++) {
    re.exec(text);
    positions.push(re.lastIndex);
  }
  console.log(JSON.stringify(positions));
}

Résultat

["a\nb","A😄b"]
[["A😄b"],["a\nb"],["a\nb"]]
[3,8,0]

La première ligne affiche les deux correspondances. Dans la deuxième, on retire tour à tour `s`, `u` et `i` de l’ensemble complet : disparaît alors la correspondance qui traverse le saut de ligne, contient l’emoji ou contient la majuscule. La troisième ligne affiche `lastIndex` après deux réussites et un échec.

Leçons associées

  • JavaScript · Leçon 10 · Avancé · Version : 4

Sources