Codificador e Decodificador de URL

O que é Codificação de URL (Codificação Percentual)?

A codificação de URL, também conhecida como codificação percentual, é um mecanismo para codificar informações em um Identificador Uniforme de Recurso (URI). Ela substitui caracteres ASCII não seguros por um "%" seguido de dois dígitos hexadecimais que representam o valor em byte do caractere. Isso garante que as URLs sejam transmitidas corretamente pela internet sem ambiguidade. Esta ferramenta codifica URLs e componentes de URI e decodifica URLs com codificação percentual de volta para texto legível.

Como Codificar uma URL

Digite ou cole sua URL na aba Codificar e a saída com codificação percentual aparece instantaneamente. O codificador usa as funções nativas do JavaScript, encodeURI e encodeURIComponent, que suportam totalmente caracteres multibyte UTF-8, incluindo emojis e escritas internacionais. Escolha entre encodeURI (para URLs completas, preserva a estrutura da URL) e encodeURIComponent (para valores de parâmetros de consulta individuais ou segmentos de caminho).

Como Decodificar uma URL

Mude para a aba Decodificar, cole sua URL com codificação percentual e o texto legível decodificado aparece instantaneamente. O decodificador lida com todas as sequências de codificação percentual (%20 para espaço, %3F para ?, %25 para %, etc.) e reconstrói corretamente os caracteres UTF-8 a partir de sequências percentuais multibyte. Se a entrada contiver sequências de codificação percentual malformadas, uma mensagem de erro explicará o problema.

encodeURIComponent vs. encodeURI

O JavaScript fornece duas funções nativas para codificação de URL. A função encodeURIComponent() codifica um componente de URI escapando todos os caracteres, exceto letras, dígitos e - _ . ! ~ * ' ( ). Ela é usada para codificar valores de parâmetros de consulta e segmentos de caminho. A função encodeURI() codifica uma URI completa, mas preserva caracteres que têm significado especial em URIs, como : / ? # [ ] @ ! $ & ' ( ) * + , ; =. Use encodeURIComponent para valores individuais e encodeURI para URLs completas.

Quando Usar a Codificação de URL

A codificação de URL é essencial ao passar entradas do usuário como parâmetros de consulta, incorporar caracteres especiais em URLs, construir requisições de API com valores dinâmicos e codificar caminhos de arquivo que contenham espaços ou caracteres internacionais. Esta ferramenta processa tudo localmente no seu navegador, garantindo que suas URLs e dados permaneçam privados.

Perguntas Frequentes

Qual é a diferença entre encodeURI e encodeURIComponent?

encodeURI é para codificar uma URL completa — ele preserva caracteres reservados de URL como /, :, ?, #, &, =. Use-o ao codificar uma string de URL completa. encodeURIComponent é para codificar um único componente (o valor de um parâmetro de consulta, um segmento de caminho, etc.) — ele codifica TODOS os caracteres reservados porque o componente pode ser inserido dentro de uma URL onde esses caracteres têm um significado especial. Regra geral: use encodeURIComponent para valores de parâmetros de consulta; use encodeURI ao lidar com uma URL completa.

Quando preciso codificar URLs?

A codificação de URL é necessária sempre que você insere caracteres não-ASCII, espaços ou caracteres reservados de URL (?, &, #, /, etc.) em uma URL. Casos comuns: passar entradas do usuário como parâmetros de consulta, construir URLs de requisição de API com valores dinâmicos, codificar caminhos de arquivo com espaços ou caracteres internacionais e construir URLs de redirecionamento.

Esta ferramenta suporta UTF-8?

Sim. O codificador usa as funções nativas do navegador encodeURI/encodeURIComponent, que suportam totalmente caracteres multi-byte UTF-8, incluindo emojis e caracteres chineses, japoneses, coreanos, árabes, hebraicos, cirílicos e latinos acentuados.

Meus dados são privados?

Sim. Toda a codificação e decodificação acontece no seu navegador. Nada é enviado para nenhum servidor. A página funciona offline depois de carregada — seguro para URLs sensíveis, endpoints de API ou parâmetros confidenciais.