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.

Como substituo quebras de linha ou tabulações?

Ative Usar Regex, porque \n (quebra de linha) e \t (tabulação) são sequências de escape regex, não texto literal. Para converter quebras de linha em espaços, busque '\n' substitua por um espaço. Para juntar parágrafos com quebras forçadas, busque '\n+' (uma ou mais quebras) substitua por ' '. Para converter tabulações em vírgulas na limpeza de CSV, busque '\t' substitua ','. Para remover retornos de carro do Windows, busque '\r' substitua por nada. Para colapsar sequências de espaços em um só, busque '\s+' substitua ' '. A caixa de substituição não interpreta \n, então para INSERIR uma quebra você precisa de regex no lado da busca; para limpeza de dados a direção mais comum (remover quebras) funciona diretamente. Dica: use Pré-visualizar primeiro para confirmar quais espaços serão tocados.

Como pré-visualizo correspondências antes de substituir (simulação)?

Clique em Pré-visualizar em vez de Substituir. Ele roda sua busca de forma não destrutiva e lista cada correspondência com cerca de 25 caracteres de contexto de cada lado, com o texto correspondente destacado, mais uma contagem total no topo. Isso resolve diretamente o problema do 'sem desfazer': você confirma o número de substituições e vê exatamente qual texto vai mudar antes de comprometer. Se esperava 5 correspondências mas a pré-visualização mostra 200, você pegou o padrão amplo demais antes de arruinar seu documento. Funciona no modo simples e em lote (cada par é rotulado com sua própria contagem) e limita às primeiras 500 correspondências para manter a página ágil. Regex inválido é reportado inline em vez de falhar silenciosamente.

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.