Codificador/Decodificador de URL
Um codificador de URL converte caracteres não permitidos em endereços web para um formato seguro chamado percent-encoding, definido pela RFC 3986. Caracteres como espaços, cedilhas, acentos e símbolos como & e ? podem quebrar uma URL ou alterar seu significado, então são substituídos por um sinal de porcentagem seguido do valor hexadecimal do byte — um espaço vira %20 e a letra 'ç' vira %C3%A7 em UTF-8. Esta ferramenta codifica e decodifica strings instantaneamente no seu navegador.
A escolha entre encodeURIComponent e encodeURI faz diferença. O encodeURIComponent escapa todos os caracteres reservados, sendo a opção correta para valores individuais de query string, dados de formulário e segmentos de caminho. Já o encodeURI preserva os caracteres que estruturam uma URL — como :, /, ? e & — e serve para codificar um endereço completo sem quebrá-lo. A decodificação faz o caminho inverso, convertendo sequências percent-encoded de volta em texto legível, útil para inspecionar parâmetros de analytics, requisições de API e links compartilhados.
Como funciona
O percent-encoding converte cada caractere inseguro em sua sequência de bytes UTF-8 e representa cada byte como % seguido de dois dígitos hexadecimais. Por exemplo, o espaço (byte 0x20) vira %20 e 'é' (bytes UTF-8 0xC3 0xA9) vira %C3%A9. O encodeURIComponent escapa tudo exceto A-Z, a-z, 0-9 e - _ . ! ~ * ' ( ), enquanto o encodeURI também preserva os delimitadores reservados ; , / ? : @ & = + $ #. A decodificação interpreta cada sequência %XX de volta ao byte original e remonta o texto UTF-8.
Casos de uso
- Codificar parâmetros de query string com espaços, acentos ou símbolos antes de montar uma URL
- Decodificar links de rastreamento e parâmetros UTM para inspecionar os dados que carregam
- Preparar URLs de requisições de API onde a entrada do usuário precisa ser embutida com segurança
- Depurar links quebrados causados por codificação dupla ou caracteres especiais não escapados
Perguntas frequentes
O que é codificação de URL e para que serve?
A codificação de URL, também chamada de percent-encoding, substitui caracteres inseguros ou reservados por um sinal de % seguido do valor hexadecimal do byte, conforme a RFC 3986. Ela é necessária porque URLs só aceitam um conjunto limitado de caracteres ASCII, e símbolos como &, ? e = têm significados estruturais. A codificação garante que dados como termos de busca ou nomes com acento trafeguem pela URL sem quebrá-la.
Qual a diferença entre encodeURI e encodeURIComponent?
O encodeURIComponent escapa todos os caracteres reservados, incluindo / ? & = e :, e deve ser usado para valores individuais como parâmetros de query. O encodeURI mantém esses delimitadores estruturais intactos, sendo adequado para codificar uma URL inteira. Usar o método errado pode quebrar a URL completa ou deixar um valor de parâmetro ambíguo.
Por que o espaço vira %20 na URL?
O caractere de espaço tem o valor de byte 0x20 em ASCII/UTF-8, e o percent-encoding representa cada byte como % seguido de dois dígitos hexadecimais, resultando em %20. No formato mais antigo application/x-www-form-urlencoded, usado por formulários HTML, o espaço também pode aparecer como sinal de mais (+), por isso as duas representações existem.
Como decodificar uma URL com %C3%A7 ou códigos parecidos?
Sequências como %C3%A7 são caracteres UTF-8 de múltiplos bytes que foram percent-encoded — nesse caso, a letra 'ç'. Cole a string em um decodificador de URL e ele converterá cada par %XX de volta ao byte correspondente, interpretando o conjunto como texto UTF-8. Esta ferramenta faz a decodificação instantaneamente no navegador, sem enviar dados a nenhum servidor.
Codificação dupla pode quebrar minhas URLs?
Sim. Se uma string já codificada for codificada de novo, os próprios sinais de % são escapados para %25, fazendo %20 virar %2520, e a URL deixa de decodificar para o texto original. Isso é comum quando vários sistemas codificam o mesmo valor. Para corrigir, decodifique repetidamente até não restarem sequências %25 e codifique exatamente uma vez.