🔗 Codificador / Decodificador URL ☆

Visão geral

Codificador e Decodificador URL cobre todas as suas necessidades de escape de URL em um só lugar. Codifique um componente com o comportamento de encodeURIComponent, codifique uma URL completa preservando a estrutura com encodeURI, decodifique percent-encoding para texto legível ou use o modo Query string para transformar uma URL longa em uma tabela legível de parâmetros e valores. O botão de troca usa o resultado como próxima entrada. Tudo roda localmente no navegador. Nada é enviado, o que importa porque URLs costumam conter chaves de API e tokens.

Qual modo usar

encodeURIComponent escapa tudo exceto caracteres não reservados, necessário para um valor de query, senão um & ou = quebra a URL. encodeURI preserva caracteres estruturais (:, /, ?, &, =) e serve para uma URL inteira. A decodificação reverte o percent-encoding, e o modo Query transforma uma URL em uma tabela legível de parâmetros, o caminho mais rápido para inspecionar rastreadores ou depurar um link quebrado.

Capacidades e restrições

Propriedade	Comportamento
Modos	encodeURIComponent, encodeURI, decodificar, tabela de query
Ida e volta	Botão de troca usa o resultado como entrada
Unicode	Percent-encoding UTF-8 completo, com emoji
Parsing de query	Parâmetros e valores em tabela legível
Processamento	100% no cliente; nada é enviado
Custo	Grátis, sem conta e sem limite

Privacidade: URLs costumam carregar segredos

Chaves de API, links assinados e tokens de sessão viajam em query strings. Tudo é processado localmente: nada é transmitido ou armazenado, e a página funciona offline. Trate a saída decodificada como sensível também.

Armadilhas de codificação

• Codifique cada valor de query separadamente; codificar a URL inteira quebra separadores.
• Não codifique duas vezes: decodifique antes para ver o que já está escapado.
• Espaços viram %20; o + só significa espaço em corpos de formulário.
• URLs assinadas podem invalidar se você recodificar.
• Use o modo query para achar parâmetros de rastreio antes de compartilhar.

Veja também as ferramentas de texto para Base64, caixa e contadores.

Codificação percentual, caracteres reservados e query strings

URLs só podem conter um conjunto limitado de caracteres, então tudo fora disso é codificado em percentual: um byte é escrito como sinal de porcentagem seguido de dois dígitos hexadecimais. As regras parecem simples até os detalhes morderem. Caracteres não reservados, letras, dígitos, hífen, sublinhado, ponto e til. Nunca precisam de codificação, enquanto reservados como barra, interrogação, ampersand e igual têm significado estrutural e só devem ser codificados quando são dados, não sintaxe. Essa distinção é a origem da maioria dos bugs: codificar uma URL inteira com função de nível componente transforma seus separadores em dados e a quebra, enquanto codificar um valor de consulta com função de nível URL deixa um ampersand dentro do valor e o divide em dois parâmetros. Espaços são caso especial: %20 é a codificação correta em um caminho, enquanto dados application/x-www-form-urlencoded tradicionalmente usam +, e misturar os dois gera sinais de mais literais no texto decodificado. Texto não latino é codificado como bytes UTF-8, então um único caractere acentuado ou letra árabe vira duas ou mais sequências percentuais, e decodificar com charset errado produz mojibake. Codificação dupla é o outro clássico: um valor já codificado é codificado de novo e %20 vira %2520. A regra prática é codificar cada componente separadamente com a função de componente, nunca a URL montada, e decodificar apenas uma vez. Tudo roda localmente no navegador.