Como usar: Codificar e decodificar URL
- Escolha a direção da conversão: Decodificar para ler um endereço cheio de %, ou Codificar para preparar um texto que vai entrar numa URL.
- Cole o endereço ou o texto no campo de entrada. O resultado aparece na hora.
- Ao codificar, escolha "Um valor" para um termo de busca ou um valor de parâmetro, ou "Endereço completo" para uma URL inteira.
- Cole um endereço em Análise da estrutura da URL para ver o domínio, o caminho e os parâmetros organizados numa tabela.
O que é codificação de URL (percent-encoding)?
Um endereço da internet (URL) só aceita letras sem acento, números e alguns símbolos. Letras acentuadas, cedilha, espaços e caracteres especiais como & são primeiro convertidos em bytes UTF-8, e cada byte é escrito como % seguido de dois dígitos hexadecimais. Isso é a codificação de URL, também chamada de percent-encoding ou URL encode.
| Caractere original | Resultado codificado |
|---|---|
| espaço | %20 (na query string também se usa +) |
| & | %26 |
| ç | %C3%A7 (2 bytes em UTF-8) |
| ã | %C3%A3 |
| é | %C3%A9 |
| ê | %C3%AA |
Cada letra acentuada vira dois blocos %XX (6 caracteres). Por isso, uma palavra simples como ação vira a%C3%A7%C3%A3o, e um endereço em português copiado e colado pode ficar longo e difícil de ler.
Diferença entre encodeURIComponent e encodeURI
encodeURIComponent codifica tudo, inclusive os símbolos da estrutura do endereço, como / ? & = #. Use para inserir um único valor de parâmetro, como um termo de busca. Assim, um & dentro do valor não é confundido com o início do próximo parâmetro.
encodeURI mantém os símbolos da estrutura e codifica apenas acentos, espaços e outros caracteres não permitidos. Use para deixar seguro um endereço completo, já montado.
- Um valor:
a&b→a%26b - Endereço completo:
https://a.com/?q=ação→https://a.com/?q=a%C3%A7%C3%A3o
Como resolver URLs com acentos que aparecem "quebradas"
Muitas vezes um endereço aparece com acentos normais na barra do navegador, mas, quando você cola no WhatsApp, num e-mail ou num documento, ele vira uma sequência cheia de %. O endereço não está errado: ele continua abrindo normalmente se você clicar. Só é preciso decodificá-lo com esta ferramenta se quiser ler o conteúdo.
Se o resultado mostrar caracteres estranhos, como �, o endereço pode vir de um site antigo que usava outra codificação (como ISO-8859-1 ou Windows-1252) em vez de UTF-8. Nesse caso, um ç pode aparecer como %E7 em vez de %C3%A7. Se alguns trechos com % estiverem cortados ou inválidos, a ferramenta decodifica o que for possível, mantém o restante sem alteração e avisa você.
Partes de uma URL
A análise da estrutura separa o endereço nestas partes:
- Protocolo: geralmente
https:. - Host (domínio): por exemplo,
tooljip.com. - Porta: aparece como padrão quando não está escrita no endereço.
- Caminho: a parte depois do domínio, como
/search. - Parâmetros: os pares
nome=valordepois do?, separados por&, mostrados já decodificados. - Hash (#): o trecho depois do
#, usado para pular para uma parte da página.