Como codificar e decodificar URLs passo a passo
Resposta rápida
Para codificar URL: cole seu texto no codificador URL e a string codificada por porcentagem aparece instantaneamente. Para decodificar: cole um URL codificado no decodificador URL e o texto original aparecerá. Todo o processamento acontece localmente no seu navegador usando encodeURIComponent() e decodeURIComponent().
Introdução
A codificação URL (também chamada de codificação percentual) converte caracteres especiais em URL em um formato que é seguro para transmissão pela Internet. Caracteres como espaços, aspas e letras não ASCII têm um significado especial em URLs ou não são permitidos. A codificação URL os substitui por um sinal de porcentagem seguido por dois dígitos hexadecimais (por exemplo, o espaço se torna% 20). Este guia mostra como codificar e decodificar URLs em seu navegador.
Passo a passo
-
Abra a ferramenta codificador/decodificador URL
Vá para a página da ferramenta URL Codificador e decodificador. A ferramenta possui dois modos: Codificar e Decodificar.
-
Digite seu texto ou URL
No modo Encode, cole o texto ou URL que deseja codificar. Isso é útil ao criar strings de consulta com valores que contêm espaços, caracteres especiais ou texto não ASCII.
-
Leia a saída codificada
A ferramenta codifica sua entrada usando encodeURIComponent(). Os espaços tornam-se% 20, caracteres especiais como & tornam-se% 26 e os caracteres não ASCII são codificados em UTF-8 e depois codificados em porcentagem. O resultado aparece instantaneamente.
-
Copie o URL codificado
Clique em Copiar para copiar a string codificada. Use-o em sua solicitação API, atributo HTML href ou chamada fetch() de JavaScript.
-
Decodifique um URL codificado
Mude para o modo Decodificar e cole uma string codificada em porcentagem. A ferramenta o decodifica usando decodeURIComponent() e mostra o texto original. Sequências de escape inválidas (como %ZZ) produzem um erro.
Exemplos
Codifique um valor de string de consulta com espaço
Entrada: hello world
Saída: hello%20world
Codifique um URL com caracteres especiais
Entrada: https://example.com/search?q=foo&bar=baz
Saída: https%3A%2F%2Fexample.com%2Fsearch%3Fq%3Dfoo%26bar%3Dbaz
Codificar texto não ASCII
Entrada: café
Saída: caf%C3%A9
Decodifique um URL codificado em porcentagem
Entrada: hello%20world%20%26%20goodbye
Saída: olá mundo e adeus
Problemas comuns
- Codificando todo o URL quando apenas os valores dos parâmetros de consulta precisam de codificação - codificar valores, não a estrutura (://?&=).
- Codificação dupla — se um URL já estiver codificado, codificá-lo novamente produzirá %2520 em vez de %20. Decodifique primeiro se não tiver certeza.
- Usando encodeURI() vs encodeURIComponent() —encodeURI() mantém caracteres estruturais URL (:/?&=), encodeURIComponent() os codifica. Use o último para valores de parâmetros de consulta.
- Sequências de escape inválidas na decodificação —%ZZ ou %2 não são codificação percentual válida e gerarão um erro.
Dicas
- Sempre codifique valores de parâmetros de consulta que possam conter espaços, caracteres especiais ou entrada do usuário para evitar injeção de URL.
- Use encodeURIComponent() para valores de parâmetros de consulta e encodeURI() para URLs completo que só precisa de caracteres inseguros codificados.
- A codificação URL não é criptografia – qualquer pessoa pode decodificá-la. Nunca use-o para ocultar dados confidenciais.
- Use nossas ferramentas de codificador e decodificador URL para processamento instantâneo e privado em seu navegador.