CKTIS / JavaScript
Resultados de RegExp: `index` e `groups`
Identifica o início da correspondência completa e lê o texto dos grupos com nome. Usa a opção `d` para obter também os limites dos intervalos.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
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 flagre.exec(text) devolve um array de resultado ou null se não houver correspondência. Verifica se o resultado é diferente de null antes de leres as suas propriedades. No array m, m[0] contém a correspondência completa; a partir de m[1] surgem as capturas, incluindo as dos grupos com nome, pela ordem dos parênteses de abertura. m.input contém toda a cadeia de entrada.
m.index é a posição inicial da correspondência completa, contada a partir de zero em unidades de código UTF-16, mesmo com a opção u. Não é um número de grupo nem re.lastIndex: com g ou y, a expressão guarda em lastIndex a posição a partir da qual começa a chamada seguinte a exec().
Um grupo escrito como (?<name>...) disponibiliza o texto capturado em m.groups.name. Sem grupos com nome, m.groups tem o valor undefined; caso contrário, é um objeto sem protótipo. Um grupo que não participou na correspondência tem o valor undefined, não a cadeia vazia "".
A opção d acrescenta m.indices: m.indices[0] dá o intervalo da correspondência completa, m.indices[1] o da primeira captura e m.indices.groups.name o da captura com nome. Cada par disponível [start, end] usa posições em unidades UTF-16 e exclui end, pelo que pode ser usado diretamente em text.slice(start, end). Se um grupo não participou, obténs undefined em vez de um par; sem d, a propriedade m.indices não existe. Verifica o suporte de d e dos grupos com nome no ambiente de execução de destino.
Com um RegExp padrão, text.match(re) sem g devolve o mesmo tipo de resultado que exec(). Com g, devolve apenas os textos das correspondências completas ou null, sem metadados por correspondência. Para obter esses metadados, percorre text.matchAll(re) com g. O iterador usa uma cópia da expressão regular cujo lastIndex é inicializado com o valor atual de re.lastIndex. Se reutilizares uma expressão com lastIndex diferente de zero, podes omitir correspondências anteriores. Para pesquisar desde o início, usa uma expressão regular nova ou define re.lastIndex = 0 antes de chamares matchAll(). Passar um RegExp sem g lança um TypeError.
Exemplos
(() => {
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
}));
})();Resultado
{"match":"id=42","index":3,"id":"42","idRange":[6,8],"slicedId":"42","unitMissing":true}O emoji ocupa duas unidades de código UTF-16 e o espaço ocupa uma, pelo que `id=42` começa em `3`. O grupo `id` captura a cadeia `"42"` no intervalo `[6, 8]`; o grupo opcional `unit` não participa.
Lições relacionadas
- JavaScript · Lição 25 · Intermédio · Versão: 3