URL Encode e Decode
Cole um texto ou uma URL e veja a versão codificada ou decodificada na hora, com a codificação percentual (%20, %C3%A7) que os navegadores usam.
Resultado
https://exemplo.com.br/busca?q=ação rápida&cidade=São Paulo
O que é a codificação de URL
Uma URL só pode ter um conjunto pequeno de caracteres ASCII. Espaços, acentos e símbolos como & e # viram uma sequência % seguida de dois dígitos hexadecimais por byte em UTF-8. O "ç" vira %C3%A7 e o espaço vira %20.
Por isso o endereço colado de um navegador costuma aparecer cheio de %. Decodificar mostra o texto original, e codificar prepara um valor para entrar com segurança numa URL.
Qual formato escolher
- Componente (encodeURIComponent): para um valor isolado, como o conteúdo de um parâmetro. Codifica / ? & = # e tudo que poderia quebrar a URL.
- URL completa (encodeURI): para um endereço inteiro. Mantém / ? & = # e : como estão, e codifica só espaços, acentos e outros caracteres inválidos.
- Formulário: igual ao componente, mas o espaço vira +. É o formato de formulários HTML e de URLSearchParams.
Erros comuns
- Codificar a URL inteira como componente, o que transforma https:// em https%3A%2F%2F e quebra o link.
- Codificar duas vezes. O % vira %25, e %20 passa a %2520. Se aparecer %25 no resultado, o texto já estava codificado.
- Decodificar um valor de formulário como componente. O + continua como + em vez de virar espaço.
Perguntas frequentes sobre URL Encode e Decode
Diferença entre os formatos, o espaço e erros de decodificação.
O encodeURI preserva os caracteres que estruturam uma URL, como / ? & = e #. O encodeURIComponent codifica todos eles, por isso serve para valores de parâmetros. Em uma URL completa, use encodeURI.
Os dois aparecem. %20 vale em qualquer parte da URL. O + vale só em formulários e na query string, no formato application/x-www-form-urlencoded. Na dúvida, use %20.
Um % precisa ser seguido de dois dígitos hexadecimais, e os bytes de uma sequência precisam formar UTF-8 válido. Quando isso falha, o decodificador nativo lança um erro. Aqui o trecho fica como está e aparece na lista de problemas.
É codificar um texto que já estava codificado: %20 vira %2520. Se o resultado tem %25, decodifique uma vez e confira se agora está certo.