Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Risultati delle corrispondenze RegExp: `index` e `groups`

Trova l’inizio della corrispondenza completa e leggi il testo dei gruppi con nome. Usa il flag `d` per ottenere anche gli estremi degli intervalli.

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

Sintassi

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) restituisce un array con il risultato oppure null se non trova una corrispondenza. Controlla che il risultato non sia null prima di leggerne le proprietà. Nell’array m, m[0] contiene la corrispondenza completa; da m[1] in poi trovi le catture, incluse quelle dei gruppi con nome, nell’ordine delle parentesi di apertura. m.input contiene l’intera stringa di ingresso.

m.index è la posizione iniziale della corrispondenza completa, contata da zero in unità di codice UTF-16 anche con il flag u. Non è il numero di un gruppo né re.lastIndex: con g o y, l’espressione memorizza in lastIndex la posizione da cui parte la chiamata successiva a exec().

Un gruppo scritto come (?<name>...) rende disponibile il testo catturato in m.groups.name. Senza gruppi con nome, m.groups vale undefined; altrimenti è un oggetto senza prototipo. Un gruppo che non ha partecipato alla corrispondenza vale undefined, non la stringa vuota "".

Il flag d aggiunge m.indices: m.indices[0] è l’intervallo della corrispondenza completa, m.indices[1] quello della prima cattura e m.indices.groups.name quello della cattura con nome. Ogni coppia disponibile [start, end] usa posizioni in unità UTF-16 ed esclude end, quindi si può usare direttamente con text.slice(start, end). Per un gruppo che non ha partecipato si ottiene undefined al posto della coppia; senza d, la proprietà m.indices è assente. Controlla che l’ambiente di destinazione supporti d e i gruppi con nome.

Con un RegExp standard, text.match(re) senza g restituisce lo stesso tipo di risultato di exec(). Con g, restituisce solo i testi delle corrispondenze complete o null, senza metadati per singola corrispondenza. Per ottenere questi metadati, itera su text.matchAll(re) con g. L’iteratore usa una copia dell’espressione regolare il cui lastIndex è inizializzato con il valore corrente di re.lastIndex. Riutilizzando un’espressione con lastIndex diverso da zero, potresti quindi saltare corrispondenze precedenti. Per cercare dall’inizio, usa una nuova espressione regolare o imposta re.lastIndex = 0 prima di chiamare matchAll(). Passare un RegExp senza g genera un TypeError.

Esempi

(() => {
  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
  }));
})();

Risultato

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

L’emoji occupa due unità di codice UTF-16 e lo spazio ne occupa una, quindi `id=42` inizia a `3`. Il gruppo `id` cattura la stringa `"42"` dall’intervallo `[6, 8]`; il gruppo facoltativo `unit` non partecipa.

Lezioni correlate

  • JavaScript · Lezione 25 · Intermedio · Versione: 3

Fonti