Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

RegExp — expressões regulares

RegExp descreve padrões para pesquisar texto. Aprende sobre flags, grupos, classes de caracteres, quantificadores e campos do resultado de exec(), incluindo capturas com nome, intervalos de índices e o comportamento com estado de lastIndex.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)

RegExp representa um padrão de texto. Cria-o com /pattern/flags ou new RegExp("pattern", "flags"); as cadeias de caracteres do construtor precisam de um nível adicional de escape das barras invertidas: /\d+/ corresponde a new RegExp("\\d+"). test() devolve um valor booleano; exec() devolve um array de correspondência ou null. Esta entrada aborda flags RegExp, grupos, classes, quantificadores e campos do resultado.

Flags: g permite correspondências sucessivas, i ignora maiúsculas e minúsculas, m faz com que ^ e $ reconheçam limites de linha, s permite que . corresponda a terminadores de linha, u ativa o modo Unicode, v amplia esse modo com operações de conjuntos de caracteres, y exige uma correspondência exatamente em lastIndex e d acrescenta intervalos de índices. u e v são mutuamente exclusivas; flags repetidas ou desconhecidas causam um SyntaxError.

Classes como [a-z], [^0-9] e \d selecionam caracteres; \d significa algarismos ASCII. Os grupos (…) capturam texto, (?<name>…) dá um nome a uma captura e (?:…) não captura. Os quantificadores *, +, ? e {n,m} significam zero ou mais, um ou mais, zero ou um e entre n e m repetições. Por predefinição são gananciosos; um ? final torna-os preguiçosos.

Um resultado de exec() contém a correspondência completa em [0], as capturas a partir de [1], a posição inicial em index, o texto original em input e as capturas com nome em groups, ou undefined se não existirem grupos com nome. As capturas sem correspondência têm o valor undefined. Só com a flag d é que o array de correspondência inclui o array indices: indices[0] é o par de índices da correspondência completa e os elementos seguintes contêm os pares das respetivas capturas ou undefined para as que não participaram na correspondência. Cada par delimita um intervalo [start,end) (com o limite final excluído) medido em unidades de código UTF-16, tal como index e lastIndex. Se o padrão não tiver capturas com nome, indices.groups tem o valor undefined. Caso contrário, é um objeto que associa a cada nome de captura o respetivo par de índices ou undefined se essa captura não tiver participado na correspondência.

Com g ou y, tanto exec() como test() alteram lastIndex: em caso de sucesso, é definido para o fim da correspondência; em caso de falha, é reposto a zero. Uma correspondência vazia não o avança automaticamente em exec(), pelo que um ciclo pode não terminar. Os grupos com nome são de ES2018, d é de ES2022 e v é de ES2024. São funcionalidades ECMAScript, não APIs Web; verifica o suporte no navegador de destino, independentemente do Node 24 no repositório.

Exemplos

const re = /(?<key>[a-z]+)=(\d{2})/dg;
const text = "id=42";
const m = re.exec(text);
if (m === null) throw new Error("Expected a match");
console.log(JSON.stringify({
  match: m[0],
  captures: [m[1], m[2]],
  key: m.groups.key,
  index: m.index,
  input: m.input,
  span: m.indices[0],
  keySpan: m.indices.groups.key,
  lastIndex: re.lastIndex
}));

Resultado

{"match":"id=42","captures":["id","42"],"key":"id","index":0,"input":"id=42","span":[0,5],"keySpan":[0,2],"lastIndex":5}

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes