Pular para o conteúdo
FrAIFlow

Soluções / Texto & Código

Por que sua regex JavaScript só passa em testes alternados

O mesmo campo passa na validação, falha sem nenhuma alteração e passa de novo. Examine a expressão regular antes de culpar a entrada. Uma expressão reutilizada com a flag global g mantém um cursor chamado lastIndex. A flag sticky y também mantém estado.

Mesma entrada, cursor em movimento
Explicação criada pelos autores com base no exemplo preservado; não é uma captura de aplicativo.

Revele o cursor por trás do resultado alternado

Um erro alternado é particularmente confuso porque o usuário não fez nada errado. Um código pode ser aceito no primeiro envio, rejeitado no segundo e aceito novamente depois de outro clique. Antes de alterar as regras de entrada, encontre onde a expressão regular é criada. Um padrão armazenado fora de um manipulador é reutilizado; movê-lo para dentro pode esconder o problema de estado sem explicá-lo.

Em uma página local de teste ou em um runtime JavaScript, mantenha uma expressão e chame-a repetidamente com um valor inofensivo. Registre o cursor antes e depois de cada chamada:

const check = /foo/g;
for (let attempt = 1; attempt <= 3; attempt++) {
  const before = check.lastIndex;
  const matched = check.test("foo");
  console.log({ attempt, before, matched, after: check.lastIndex });
}

O cursor deve avançar para 3 após uma correspondência e voltar a 0 após uma falha. A próxima tentativa começa novamente no início. Isso torna visível a aparente aleatoriedade. Use uma expressão descartável no teste: as próprias chamadas de diagnóstico avançam uma regex com estado e podem alterar o comportamento que você tenta examinar.

Um relato público de 2013 descreveu esse comportamento alternado. A amostra preservada de Node.js v24.19.0 o reproduziu com uma expressão e uma string:

const pattern = /foo/g;
pattern.test("foo"); // true;  lastIndex = 3
pattern.test("foo"); // false; lastIndex = 0
pattern.test("foo"); // true;  lastIndex = 3

A primeira correspondência move o cursor para o fim. A chamada seguinte começa ali, não encontra nada e o redefine. Mudar a string de entrada não reinicia automaticamente a expressão: o cursor pertence ao objeto RegExp.

Separe verificação de varredura
Explicação criada pelos autores com base no exemplo preservado; não é uma captura de aplicativo.

Mantenha a validação independente sem estado

Em uma verificação comum de formulário, altere o validador uma vez em vez de espalhar reinicializações de cursor pelos manipuladores de clique. Preserve flags necessárias, como ignorar maiúsculas e minúsculas, mas remova global ou sticky quando cada entrada deve ser avaliada independentemente. Procure outros usos do mesmo objeto no código antes de alterá-lo. Um scanner que coleta várias correspondências pode realmente depender desse cursor.

O exemplo ABC-1234 abaixo é uma verificação de formato, não uma regra para todo tipo de identificador. Se exigir um valor de uma linha, rejeite explicitamente quebras de linha. A âncora de fim do JavaScript tem nuances com finais de linha, e o modo multilinha altera ainda mais o comportamento das âncoras. Defina se espaços nas extremidades são erro ou uma normalização aceita e informe a regra em vez de mudar silenciosamente os dados.

const code = /^[A-Z]{3}-\d{4}$/;
["ABC-1234", "ABC-1234", "ABC-1234"]
  .map(value => code.test(value));
// [true, true, true]

Separe a varredura intencional

function independentTest(pattern, text) {
  pattern.lastIndex = 0;
  return pattern.test(text);
}

Esta função modifica a expressão fornecida. Não a coloque em um laço de varredura que avança deliberadamente entre correspondências. Prefira um validador separado quando houver varredura e validação; callbacks de arrays não reiniciam o cursor por você.

Os testes preservados produziram [true, false, true] com a expressão global e três resultados true tanto sem g quanto com uma reinicialização explícita. É um resultado específico no Node, não uma auditoria completa de compatibilidade entre navegadores. Se a falha persistir depois de remover o estado, examine a expressão, caracteres ocultos e pressupostos Unicode em vez de adicionar mais reinicializações.

Confira a correção no formulário real

Teste o mesmo valor válido várias vezes, depois um inválido e, em seguida, o válido novamente. Teste também dois valores válidos diferentes em sequência. A resposta deve depender de cada valor, não da ordem de envio. Repita essa pequena sequência pelo formulário real para que manipuladores de perda de foco, validação ao digitar e validação no envio usem a regra pretendida.

Se ainda houver erro, examine os caracteres exatos e as flags restantes. Não adicione uma reinicialização depois de toda chamada como solução universal: isso pode quebrar um laço intencional de varredura em outro lugar. Manter o validador separado do scanner é mais fácil de entender e manter do que usar um objeto com estado para ambas as tarefas.

Sequência de teste medida: true com cursor 3, false com cursor 0 e depois true com cursor 3.
Explicação original preservada.
Saída registrada do teste sintético sobre regex JavaScript que só passa em testes alternados
Resultados registrados de RegExp.test no Node.js v24.19.0 com entradas idênticas repetidas. É uma captura da saída de teste registrada, não do aplicativo do autor do relato. Abrir a imagem de evidência em tamanho original.

Fontes e leituras relacionadas