Aprenda depurando

Laboratório de erros de Regex: depure 8 padrões reais

Aprenda a detectar falsos positivos e falsos negativos antes de colocar uma expressão regular em produção. Cada erro tem uma versão defeituosa, uma correção explicada e dois testes reproduzíveis.

Como usar este laboratório

  1. Leia o requisito e tente prever qual entrada quebra o padrão antigo.
  2. Execute o caso válido, depois o contraexemplo, no Playground.
  3. Abra a explicação, compare as versões e revise a Regex para seu requisito.

As expressões são exemplos didáticos de JavaScript. Algumas verificam somente o formato, não a validade de dados reais.

8 erros que parecem pequenos, mas mudam o resultado

Os testes indicam a diferença entre corresponder à string inteira e encontrar apenas um trecho.

Erro real de Regex

O ponto precisa ser literal

Um nome de arquivo tem ponto de verdade. O operador . corresponde a praticamente qualquer caractere; \. representa um ponto.

Padrão problemático
^relatorio.csv$
Padrão revisado
^relatorio\.csv$

Deve funcionar: relatorio.csv

Deve falhar: relatorioXcsv

Flags: nenhuma

Por que a primeira expressão falha?

A versão incorreta também aceita relatorioXcsv, que não é um arquivo CSV com o nome esperado.

Use escape em caracteres que devem ser literais, inclusive ponto, colchetes e sinais de mais.

Erro real de Regex

Validar o campo inteiro, não um pedaço

Uma busca por CEP pode encontrar uma sequência dentro de uma frase. Um campo de formulário costuma exigir que todo o valor seja o CEP.

Padrão problemático
\d{5}-\d{3}
Padrão revisado
^\d{5}-\d{3}$

Deve funcionar: 40100-010

Deve falhar: CEP 40100-010!

Flags: nenhuma

Por que a primeira expressão falha?

Sem ^ e $, o trecho dentro de CEP 40100-010! é aceito como correspondência parcial.

As âncoras verificam o formato do campo; não comprovam que o CEP existe.

Erro real de Regex

Alternância sem agrupamento muda o significado

A expressão ^cat|dog$ é interpretada como “começa com cat OU termina com dog”, não como uma escolha exata entre dois valores.

Padrão problemático
^cat|dog$
Padrão revisado
^(?:cat|dog)$

Deve funcionar: dog

Deve falhar: catfish

Flags: nenhuma

Por que a primeira expressão falha?

catfish passa pelo lado esquerdo da alternância. O grupo (?:...) coloca as duas opções sob as mesmas âncoras.

Em validações de listas curtas, agrupe as alternativas antes de aplicar âncoras.

Erro real de Regex

O curinga guloso engole texto demais

Se o requisito é reconhecer um único campo entre aspas em uma linha, .* pode atravessar aspas internas e consumir um trecho maior que o permitido.

Padrão problemático
^".*"$
Padrão revisado
^"[^"\n]*"$

Deve funcionar: "cat"

Deve falhar: "cat" and "dog"

Flags: nenhuma

Por que a primeira expressão falha?

A versão incorreta também aceita "cat" and "dog". A classe negada impede aspas adicionais no conteúdo.

Para CSV completo, escape de aspas e quebras de linha, use um parser CSV apropriado.

Erro real de Regex

O asterisco aceita campo vazio

Em um SKU que exige pelo menos uma letra, * está incorreto porque significa zero ou mais ocorrências.

Padrão problemático
^SKU-[A-Z]*$
Padrão revisado
^SKU-[A-Z]+$

Deve funcionar: SKU-AB

Deve falhar: SKU-

Flags: nenhuma

Por que a primeira expressão falha?

A versão incorreta aceita SKU-, sem o código obrigatório. + exige uma ou mais letras.

Defina tamanho mínimo e máximo a partir das regras reais do seu catálogo.

Erro real de Regex

O prefixo de log precisa ter limite

Filtrar logs apenas por ^ERROR não impede que palavras mais longas começando com ERROR sejam tratadas como nível de severidade.

Padrão problemático
^ERROR
Padrão revisado
^ERROR(?:\s|$)

Deve funcionar: ERROR requestId=ab-123

Deve falhar: ERRORFUL OK

Flags: nenhuma

Por que a primeira expressão falha?

ERRORFUL OK casa com a versão incorreta. A nova versão exige espaço ou fim da linha após ERROR.

Para arquivos com várias linhas use m; se o formato for JSON, prefira campos estruturados.

Erro real de Regex

Um sinal de mais literal deve ser escapado

Ao procurar um código de produto que contém +, não deixe o caractere ser interpretado como quantificador.

Padrão problemático
^a+b$
Padrão revisado
^a\+b$

Deve funcionar: a+b

Deve falhar: aaab

Flags: nenhuma

Por que a primeira expressão falha?

A expressão incorreta aceita aaab e não aceita a+b. A barra invertida transforma o sinal de mais em texto literal.

Quando o padrão vier de entrada do usuário, escape metacaracteres em vez de concatenar a entrada diretamente.

Erro real de Regex

Apenas A–Z não cobre nomes com acentos

Uma regra restrita ao alfabeto ASCII pode rejeitar nomes perfeitamente válidos como João.

Padrão problemático
^[A-Za-z]+$
Padrão revisado
^\p{L}+$

Deve funcionar: João

Deve falhar: Joao3

Flags: u

Por que a primeira expressão falha?

Com flag u, \p{L} considera letras Unicode; este exemplo ainda não aceita espaços, hífens ou apóstrofos.

Nomes reais têm regras mais amplas: decida requisitos de UX antes de bloquear caracteres.

Casos reais: da Regex ao fluxo do produto

A Regex é um componente da solução, não a solução completa. Veja quatro fluxos comuns de produto e backend.

Cadastro com e-mail

Antes de salvar um cadastro, remova espaços externos e verifique um formato comum; depois envie um link de confirmação.

Padrão de demonstração:

^[^\s@]+@[^\s@]+\.[^\s@]+$

Aceita: dev@example.com

Rejeita: dev@example

Limite importante: Esse padrão é didático: não verifica a existência da caixa postal, não implementa todos os casos da RFC e não substitui validação no servidor.

Leia o guia de e-mail para entender essas limitações.

Investigar erros por requestId

Separe eventos ERROR de INFO e capture um identificador para correlacionar registros sem depender da mensagem completa.

Padrão de demonstração:

^ERROR\s+requestId=(?<id>[a-z]{2}-\d{3})\b

Aceita: ERROR requestId=ab-123 Timeout

Rejeita: INFO requestId=ab-123 OK

Limite importante: A estrutura do log deve ser conhecida. Logs JSON e sistemas de observabilidade são melhores para dados estruturados.

Aprenda a extrair IDs de logs.

SKU em um sistema de estoque

Valide a forma do código antes de consultar o catálogo: categoria conhecida, duas letras e três dígitos.

Padrão de demonstração:

^(?:BK|EL|HM)-[A-Z]{2}-\d{3}$

Aceita: EL-AB-123

Rejeita: XX-AB-123

Limite importante: A Regex não garante que o SKU esteja cadastrado, disponível ou associado ao produto correto.

Pratique com outros exercícios.

Data de agendamento

Verifique primeiro a forma DD/MM/AAAA. Depois converta os componentes e confira se o dia existe naquele mês e ano.

Padrão de demonstração:

^\d{2}/\d{2}/\d{4}$

Aceita: 15/11/2026

Rejeita: 15-11-2026

Limite importante: 31/02/2026 também casa com esta Regex; verificar o calendário exige código adicional.

Veja validação de datas.

Depuração completa: por que a alternância aceita valores errados?

O padrão defeituoso ^cat|dog$ significa “começa com cat OU termina com dog”. Por isso, aceita catfish e hotdog. Use um grupo não capturante para aplicar as âncoras às duas alternativas.

cat → aceito; dog → aceito; catfish e hotdog → rejeitados pelo padrão corrigido.

const broken = /^cat|dog$/;
const fixed = /^(?:cat|dog)$/;
console.log(broken.test("catfish")); // true: bug
console.log(broken.test("hotdog"));  // true: bug
console.log(fixed.test("cat"));      // true
console.log(fixed.test("dog"));      // true
console.log(fixed.test("catfish"));  // false
console.log(fixed.test("hotdog"));   // false

O grupo (?:...) organiza alternativas sem criar uma captura desnecessária.

Checklist antes de usar Regex em produção

  • Escreva requisitos e contraexemplos antes de escrever símbolos.
  • Decida se quer extrair um trecho ou validar a string inteira.
  • Teste Unicode, strings vazias, limites e dados inesperados.
  • Evite quantificadores aninhados sobre entradas grandes e não confie na Regex para autenticação ou segurança.
  • Meça o resultado no Playground e valide regras de negócio em código.