Guia de utilização
O que é e para que serve
Converte texto entre a sua forma normal e três codificações muito comuns na web —URL (percent-encoding), Base64 e entidades HTML— e também em sentido inverso. Serve para preparar parâmetros de um URL, incorporar dados em JSON/XML ou escapar texto para não quebrar o HTML. Tudo acontece no seu navegador: nada é enviado para nenhum servidor.
Utilização básica
Escolhe Codificar ou Descodificar e escreve o texto: a conversão para URL, Base64 e entidades HTML é calculada de imediato e podes copiar cada resultado.
Quando usar cada um
Base64 é adequado para incorporar dados binários em JSON/XML. URL encoding é obrigatório nos parâmetros de uma query string. As entidades HTML evitam que o texto seja interpretado como marcação (proteção contra XSS).
URL (percent-encoding)
Substitui os carateres que não são seguros num URL por % seguido do seu código em bytes UTF-8. É obrigatório nos parâmetros de uma query string.
• Codificar: correo=me@x.com&t=1 → correo%3Dme%40x.com%26t%3D1 (o = passa a %3D, o @ a %40, o & a %26).
• Um espaço converte-se em %20 e as letras acentuadas em vários bytes: á → %C3%A1.
• Descodificar faz o caminho inverso: hola%20mundo → hola mundo.
Base64
Representa qualquer texto (tratado como bytes UTF-8) usando apenas 64 carateres imprimíveis (A–Z a–z 0–9 + /) e = como preenchimento. Usa-se para incorporar dados binários em locais que só admitem texto, como JSON ou XML.
• Codificar: Hola → SG9sYQ==. Com acentos: café → Y2Fmw6k= (o é são dois bytes UTF-8).
• Descodificar: SG9sYQ== → Hola. Se o texto não for um Base64 válido, a linha mostra —.
• Usa o alfabeto padrão (+ e /), não a variante «URL-safe».
Entidades HTML
Converte os carateres com significado especial em HTML nas suas entidades, para que o navegador os mostre como texto e não os interprete como marcação (isto evita quebrar a página e protege contra XSS).
• Codificar escapa cinco carateres: &→&, <→<, >→>, "→" e '→'. Exemplo: <b>Hola</b> → <b>Hola</b>.
• Descodificar faz o inverso e ainda reconhece (espaço), © (©), ® (®), ™ (™) e as entidades numéricas decimais A (A).
Os três formatos
URL codifica os caracteres especiais com % (percent-encoding). Base64 representa o texto com 64 caracteres imprimíveis. HTML converte < > & " ' nas respetivas entidades.
