Codificador / descodificador de URL

Os URLs só podem conter um conjunto limitado de caracteres, por isso tudo o que fica fora desse conjunto, espaços, letras acentuadas e símbolos reservados como & ? / =, tem de ser escapado. A codificação por percentagem substitui cada um desses bytes por um sinal de percentagem e o seu valor hexadecimal de dois dígitos, por isso um espaço torna-se %20 e um e comercial torna-se %26.

Esta ferramenta codifica texto e URLs para a forma codificada por percentagem e descodifica-os de volta. Assenta nas funções padrão encodeURIComponent e encodeURI do navegador, por isso a saída corresponde exatamente ao que o seu próprio JavaScript produziria, e é segura em UTF-8 para texto internacional.

A codificação e a descodificação correm inteiramente no seu navegador, por isso nada do que colar é enviado para um servidor, o que é tranquilizador quando um URL contém tokens ou parâmetros de consulta que prefere não partilhar.

O interruptor de âmbito importa. O modo componente (encodeURIComponent) escapa caracteres reservados como & = ? / e é o que quer para um único valor de query-string ou segmento de caminho. O modo URL completo (encodeURI) deixa os caracteres estruturais intactos, para que um URL completo continue utilizável.

Um erro comum é codificar um URL inteiro em modo componente, o que escapa o :// e o ? e quebra o link. Outro é a dupla codificação, em que uma cadeia já codificada é codificada de novo e %20 se transforma em %2520. Na dúvida, descodifica primeiro para ver o valor em bruto.

Há também uma particularidade histórica nas query strings: as submissões de formulário codificam um espaço como um sinal de mais, enquanto a codificação por percentagem usa %20. Ambas aparecem por aí, por isso os descodificadores geralmente aceitam qualquer uma.