Codificador / Decodificador de URL

Um codificador de URL converte caracteres que não podem ser utilizados diretamente numa URL em sequências codificadas percentualmente. Um decodificador de URL inverte o processo, transformando texto codificado percentualmente nos caracteres originais. Esta página faz as duas coisas, em ambas as direções, para um único componente de URL ou uma URL completa.

A ferramenta utiliza as quatro funções JavaScript padrão:

• encodeURIComponent — para codificar um único componente de URL, como o valor de um parâmetro de consulta.
• encodeURI — para codificar uma URL completa preservando os caracteres reservados como : / ? # & = que têm significado estrutural.
• decodeURIComponent — para decodificar um único componente de URL de volta aos seus caracteres originais.
• decodeURI — para decodificar uma URL completa sem tocar nos caracteres reservados.

Todas as conversões são compatíveis com UTF-8, para que letras acentuadas, emoji e caracteres de scripts não latinos sejam processados corretamente. Nada é enviado, nada é armazenado e não são feitas chamadas a API.

Alguns exemplos práticos de como a codificação URL funciona na prática:

• Um espaço torna-se %20, por isso olá mundo é codificado como ol%C3%A1%20mundo.
• Uma barra numa cadeia de consulta torna-se %2F, por isso a/b torna-se a%2Fb como parâmetro.
• Um ponto de interrogação num valor torna-se %3F, por isso o quê? torna-se o%20qu%C3%AA%3F.
• Um ampersand num valor torna-se %26, o que evita quebrar a cadeia de consulta envolvente.
• Um cardinal num valor torna-se %23, por isso c# torna-se c%23.
• Caracteres não ASCII usam sequências UTF-8 multibyte. Por exemplo café torna-se caf%C3%A9 (o é representa dois bytes UTF-8).
• Emoji também usam UTF-8 multibyte: 😀 torna-se %F0%9F%98%80.

Mude a ferramenta para Decodificar e cole qualquer uma destas cadeias codificadas para ver o texto original restaurado exatamente.

Escolher o modo correto é importante porque os dois codificadores tratam os caracteres reservados de forma diferente.

Use o modo Componente (encodeURIComponent / decodeURIComponent) quando codificar um valor individual que será inserido numa URL — por exemplo o valor de um parâmetro de consulta, um segmento de caminho ou um valor de fragmento. O modo Componente codifica percentualmente os caracteres reservados (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) para que não possam alterar acidentalmente a estrutura da URL envolvente.

Use o modo URL Completa (encodeURI / decodeURI) quando tiver uma URL completa como https://exemplo.pt/caminho?consulta=valor#fragmento e quiser apenas escapar os caracteres inseguros (por exemplo espaços ou caracteres não ASCII), sem tocar nos caracteres estruturais reservados.

Um erro comum é usar encodeURI num valor que deveria ser um parâmetro de consulta. Os caracteres reservados ficam intactos, o que pode corromper a URL envolvente. Em caso de dúvida, codifique cada valor de consulta com encodeURIComponent e monte a URL depois.

A codificação percentual (também chamada codificação URL) é uma forma de representar numa URL caracteres reservados (com significado estrutural) ou não permitidos. Cada byte inseguro é escrito como um sinal de percentagem seguido de dois dígitos hexadecimais — por exemplo %20 para um espaço, %2F para uma barra ou %3F para um ponto de interrogação.

A codificação trabalha em bytes, não diretamente em caracteres. As URL modernas usam UTF-8 para converter os caracteres em bytes primeiro, razão pela qual uma única letra acentuada pode gerar dois bytes codificados percentualmente e um emoji pode gerar quatro. Esta ferramenta usa sempre UTF-8, para que as cadeias codificadas sejam interoperáveis com o resto da web.

A codificação percentual está definida pelo RFC 3986. As funções JavaScript nativas aqui usadas implementam essa especificação, pelo que um valor codificado com encodeURIComponent em qualquer navegador moderno é decodificado corretamente com decodeURIComponent em qualquer outro lugar.

Este codificador decodificador de URL é útil sempre que precisar de mover texto de forma segura para dentro ou fora de uma URL. Cenários comuns:

• Codificar texto para uma cadeia de consulta antes de o colar num pedido de API, numa linha de registo ou na barra de endereço do navegador.
• Decodificar parâmetros de URL de um registo de pedidos ou exportação de análises para ler os valores originais.
• Inspecionar uma URL longa codificada ao decodificá-la e verificar o que está realmente a ser transmitido.
• Escapar caracteres especiais numa URL antes de a partilhar em chat, documentação ou payload JSON.
• Aprender como a codificação percentual e as sequências de bytes UTF-8 se mapeiam para os caracteres.

Como a ferramenta é executada totalmente no navegador, é também adequada para URL sensíveis (ligações internas, tokens, URL assinadas) que prefere não colar num serviço remoto.

A codificação URL e a limpeza de URL são duas operações diferentes que frequentemente se confundem.

A codificação URL (esta ferramenta) transforma caracteres em forma codificada percentualmente e inverte a operação. A estrutura da URL é preservada; nada é adicionado ou removido.

A limpeza de URL (um tipo de ferramenta distinto) remove parâmetros de rastreio como utm_source, utm_medium, fbclid, gclid e chaves de consulta semelhantes de uma URL, para que a ligação resultante não contenha metadados de rastreio. A limpeza altera os parâmetros na URL — a codificação não.

Se quiser remover parâmetros de rastreio, precisa de um limpador de URL dedicado. Se quiser codificar ou decodificar texto em forma codificada percentualmente, esta é a ferramenta certa.