Codificador / Decodificador de URL

Um codificador de URL converte caracteres que não podem ser usados diretamente em uma URL em sequências codificadas percentualmente. Um decodificador de URL inverte esse processo, transformando texto codificado percentualmente de volta 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 usa as quatro funções JavaScript padrão:

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

Todas as conversões são compatíveis com UTF-8, então letras acentuadas, emojis e caracteres de scripts não latinos são processados corretamente. Nada é carregado, nada é armazenado e não há chamadas de API.

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

• Um espaço vira %20, então olá mundo é codificado como ol%C3%A1%20mundo.
• Uma barra em um valor de query vira %2F, então a/b vira a%2Fb como parâmetro.
• Um ponto de interrogação em um valor vira %3F, então o quê? vira o%20qu%C3%AA%3F.
• Um ampersand em um valor vira %26, evitando quebrar a query string ao redor.
• Um cerquilha em um valor vira %23, então c# vira c%23.
• Caracteres não ASCII usam sequências UTF-8 de múltiplos bytes. Por exemplo café vira caf%C3%A9 (o é são dois bytes UTF-8).
• Emojis também usam UTF-8 de múltiplos bytes: 😀 vira %F0%9F%98%80.

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

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

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

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

Um erro comum é usar encodeURI em um valor que deveria ser um parâmetro de query. Os caracteres reservados ficam intactos, o que pode corromper a URL ao redor. Na dúvida, codifique cada valor com encodeURIComponent e monte a URL depois.

Codificação percentual (também chamada de codificação de URL) é uma forma de representar em uma URL caracteres reservados (com significado estrutural) ou não permitidos. Cada byte inseguro é escrito como um sinal de porcentagem 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. URLs modernas usam UTF-8 para converter 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 sempre usa UTF-8 para que strings codificadas sejam interoperáveis com o resto da web.

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

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

• Codificar texto para uma query string antes de colá-lo em uma requisição de API, linha de log ou barra de endereços do navegador.
• Decodificar parâmetros de URL de um log de requisições ou exportação de analytics para ler os valores originais.
• Inspecionar uma URL longa codificada decodificando ela e verificando o que está sendo transmitido de fato.
• Escapar caracteres especiais em uma URL antes de compartilhá-la 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 roda completamente no navegador, também é adequada para URLs sensíveis (links internos, tokens, URLs assinadas) que você prefere não colar em um serviço remoto.

Codificação de URL e limpeza de URL são duas operações distintas que são frequentemente confundidas.

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

Limpeza de URL (um tipo diferente de ferramenta) remove parâmetros de rastreamento como utm_source, utm_medium, fbclid, gclid e chaves de query similares de uma URL, para que o link resultante não contenha mais metadados de rastreamento. A limpeza altera os parâmetros na URL — a codificação não.

Se quiser remover parâmetros de rastreamento, precisará de uma ferramenta dedicada de limpeza de URL. Se quiser codificar ou decodificar texto em forma codificada percentualmente, esta é a ferramenta certa.