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

CKTIS / JavaScript

Résultat RegExp : `index` et `groups`

Repérez le début de la correspondance complète et lisez le texte des groupes nommés. Le drapeau `d` donne aussi accès aux bornes.

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

Syntaxe

const m = re.exec(text); // Match array or null
// After checking m !== null:
m.index;            // Start of the full match
m[0];               // Full matched text
m[1];               // First capture, if present
m.groups?.name;     // Text from (?<name>...) if it matched
m.indices?.[0];     // Full match range with the d flag
m.indices?.groups?.name; // Named capture range with the d flag

re.exec(text) renvoie un tableau de résultat ou null s’il n’y a pas de correspondance. Vérifiez que le résultat n’est pas null avant de lire ses propriétés. Dans le tableau m, m[0] contient la correspondance complète. À partir de m[1] viennent les captures, y compris celles des groupes nommés, dans l’ordre des parenthèses ouvrantes. m.input contient la chaîne d’entrée entière.

m.index est la position de début de la correspondance complète, comptée à partir de zéro en unités de code UTF-16, même avec le drapeau u. Ce n’est ni un numéro de groupe ni re.lastIndex : avec g ou y, l’expression stocke dans lastIndex la position à partir de laquelle le prochain appel à exec() démarre.

Un groupe écrit (?<name>...) donne accès au texte capturé dans m.groups.name. Sans groupe nommé, m.groups vaut undefined ; sinon, c’est un objet sans prototype. Un groupe qui n’a pas participé à la correspondance vaut undefined, et non la chaîne vide "".

Le drapeau d ajoute m.indices : m.indices[0] donne les bornes de la correspondance complète, m.indices[1] celles de la première capture et m.indices.groups.name celles de la capture nommée. Chaque paire disponible [start, end] est exprimée en unités UTF-16 et exclut end ; elle convient donc directement à text.slice(start, end). Un groupe qui n’a pas participé donne undefined à la place d’une paire ; sans d, la propriété m.indices est absente. Vérifiez la prise en charge de d et des groupes nommés dans l’environnement cible.

Avec un RegExp standard, text.match(re) sans g donne le même type de résultat que exec(). Avec g, il ne renvoie que les textes des correspondances complètes ou null, sans métadonnées par correspondance. Pour obtenir ces métadonnées, parcourez text.matchAll(re) avec g. L’itérateur utilise une copie de l’expression régulière dont le lastIndex est initialisé à la valeur actuelle de re.lastIndex. Si vous réutilisez une expression dont le lastIndex est non nul, des correspondances antérieures peuvent donc être ignorées. Pour chercher depuis le début, utilisez une nouvelle expression régulière ou définissez re.lastIndex = 0 avant d’appeler matchAll(). Passer un RegExp sans g déclenche une TypeError.

Exemples

(() => {
  const text = "😀 id=42";
  const m = /id=(?<id>\d+)(?<unit>ms)?/du.exec(text);
  if (m === null) throw new Error("Expected a match");

  const [start, end] = m.indices.groups.id;
  console.log(JSON.stringify({
    match: m[0],
    index: m.index,
    id: m.groups.id,
    idRange: [start, end],
    slicedId: text.slice(start, end),
    unitMissing: m.groups.unit === undefined
  }));
})();

Résultat

{"match":"id=42","index":3,"id":"42","idRange":[6,8],"slicedId":"42","unitMissing":true}

L’emoji occupe deux unités de code UTF-16 et l’espace en occupe une : `id=42` commence donc à `3`. Le groupe `id` capture la chaîne `"42"` entre les bornes `[6, 8]` ; le groupe facultatif `unit` ne participe pas.

Leçons associées

  • JavaScript · Leçon 25 · Intermédiaire · Version : 3

Sources