Substituidor de Palavras

Sobre a Ferramenta Substituidor de Palavras

Substituidor de Palavras é um utilitário de localizar e substituir baseado no navegador com quatro modos de correspondência — substring literal, substring sensível à caixa, palavra inteira (consciente de fronteiras de palavra) e expressão regular JavaScript completa (sabor ECMAScript com flags /g, /i, /m, /s). O modo literal usa String.prototype.replaceAll() para combinação bruta de caracteres. O modo palavra inteira envolve seu termo de busca com âncoras de fronteira \b, então 'gato' não combinará dentro de 'gatos' ou 'categoria'. O modo regex passa seu padrão direto para um construtor RegExp — permitindo usar grupos de captura, lookahead/lookbehind, classes de caracteres, quantificadores e retro-referências ($1, $2) na string de substituição. O modo em lote lê um par localizar→substituir por linha (dividido pela seta ASCII '→' ou o '->' amigável ao teclado) e os aplica em ordem, de cima para baixo — significando que pares posteriores veem a saída dos anteriores, o que é útil para transformações encadeadas mas também uma armadilha se uma substituição posterior re-combinar com saída anterior. Fluxos típicos: localizar-e-substituir nomes de variáveis em um trecho de código (modo palavra inteira), corrigir erros de digitação em documento longo, ocultar PII com regex como \b\d{3}-\d{2}-\d{4}\b para CPFs/SSNs, normalizar formatos de dados (DD/MM/AAAA para AAAA-MM-DD via regex), e rodar trocas de glossário de tradução com modo em lote.

Qual a diferença entre 'Apenas Palavra Inteira' e um regex com \b?

Funcionalmente idênticos. O modo palavra inteira apenas envolve seu termo literal em \b...\b automaticamente e escapa primeiro caracteres especiais de regex, então '$5' busca literalmente o token dólar-5 sem você ter que escapar o cifrão. Se quer correspondência de fronteira de palavra mais recursos regex (alternância, quantificadores), ative Usar Regex e escreva o \b você mesmo: '\b(gato|cachorro)\b' combina a palavra isolada gato ou cachorro mas não 'gatos' ou 'cachorrinho'.

As flags de regex JavaScript /g, /i, /m, /s são suportadas?

Sim implicitamente. A ferramenta sempre usa /g (global) então todas as correspondências são substituídas de uma vez (ou só a primeira se você escolher esse modo, que desliga a flag). A opção sensível à caixa alterna /i. A flag /m (âncoras ^ e $ multilinha por linha) e /s (ponto combina com quebra de linha) não estão diretamente expostas — mas se você escrever seu padrão inline como 'foo$' ele só vai combinar no final da string por padrão. Para ancorar por linha, use a flag inline (?m) no início: '(?m)foo$' combina 'foo' no final de qualquer linha. Para dotall, use '[\s\S]' como alternativa portátil ao /s.

Posso usar grupos de captura e retro-referências ($1, $2) na substituição?

Sim — Substituidor de Palavras usa String.replace() nativo do JavaScript então todos os padrões de substituição padrão funcionam: $& (correspondência inteira), $` (texto antes), $' (texto depois), $1-$99 (grupos numerados), $<nome> (grupos nomeados via sintaxe (?<nome>...)). Exemplo: busque '(\w+)@(\w+\.\w+)' e substitua por '$1 em $2' converte '[email protected]' para 'ana em exemplo.com'. Útil para trocar formatos de data — busque '(\d{2})/(\d{2})/(\d{4})' substitua '$3-$2-$1' converte '24/12/2025' para '2025-12-24' (ISO 8601).

Como funciona a ordenação da Substituição em Lote — um par posterior pode re-combinar com saída anterior?

Sim, e é uma armadilha comum. Cada par roda em sequência no estado atual do texto. Se o par 1 muda 'gato' para 'cachorro' e o par 2 muda 'cachorro' para 'cavalo', você termina com 'cavalo' por toda parte — não o que você queria. Solução: use um marcador para a primeira passada. Par 1: 'gato' → '__TMP1__'. Par 2: 'cachorro' → 'cavalo'. Par 3: '__TMP1__' → 'cachorro'. Isso garante independência. O modo em lote é linha por linha no formato 'localizar → substituir' (use → ou -> como separador); linhas em branco ou mal formadas são ignoradas.

Por que minha busca regex não encontra o que espero?

Três causas comuns. Primeira, caracteres especiais não escapados: ponto (.), asterisco (*), mais (+), interrogação (?), parênteses, colchetes, chaves, barra invertida, circunflexo, cifrão, pipe — devem ser escapados com barra invertida para combinar literalmente. Segunda, quantificadores gulosos vs preguiçosos: '<.*>' combina do primeiro '<' ao último '>' na linha; use '<.*?>' para combinação preguiçosa. Terceira, sensibilidade à caixa — se seu texto é 'OLÁ' mas você busca 'olá' sem ativar insensível à caixa, sem correspondência. Teste numa amostra pequena primeiro; o contador Correspondências Encontradas mostra zero quando nada combina.

Existe botão de desfazer se a substituição foi errada?

Sem desfazer integrado — mas você pode prevenir desastres copiando o original para uma segunda aba primeiro (área de transferência) ou rodando o modo Substituir Apenas a Primeira como teste antes de comprometer Substituir Todas. O contador 'Total de Substituições' mostrado após cada execução te diz quantas substituições aconteceram, então um número inesperadamente alto (digamos esperava 5 mas teve 200) é um alerta vermelho para inspecionar a saída antes de colá-la de volta em produção. Atualizar a aba perde tudo — copie o resultado antes de navegar.

Meu texto sai do navegador?

Não. Toda busca/substituição roda em JavaScript do navegador via String.replace() e RegExp diretamente no valor do textarea. Sem fetch() para servidor, sem analytics com conteúdo, sem escrita no localStorage. A aba Network do DevTools confirma zero requisições de saída ao clicar Substituir. Seguro para conteúdo sensível como código fonte interno, PII de clientes, documentos legais ou chaves de criptografia — nada é enviado ou registrado.