Como usar o Codificador / decodificador de URL: guia completo (2026)

O que é o Codificador / decodificador de URL?

O Codificador / decodificador de URL é um utilitário grátis que roda no navegador, no ToolsMinify. Use este codificador e decodificador de URL grátis para converter texto e links em percent-encoding (codificação de URL) ou decodificar uma URL codificada de volta em texto legível. Escolha entre encodeURIComponent - que escapa caracteres reservados como &, =, ? e / para que um valor seja seguro dentro de uma query string - ou encodeURI, que mantém intacta a estrutura de uma URL completa. Tudo roda no lado do cliente, no seu navegador, então nada é enviado. Não exige cadastro, processa os dados localmente quando possível e foi feito para ser rápido no celular e no computador.

Codifique texto e URLs em percent-encoding ou decodifique URLs codificadas para texto puro. Alterne entre encodeURIComponent e encodeURI no navegador.

Por que usar o Codificador / decodificador de URL?

• Evite instalar um pacote só para uma transformação pontual
• A validação pega entradas malformadas antes de chegarem à produção
• Copie a saída pronta para colar no código, no SQL ou no corpo de uma requisição
• Tudo roda no cliente, então o payload nunca sai da sua máquina

Como usar o Codificador / decodificador de URL passo a passo

1. Passo 1: Escolha Codificar ou Decodificar com os botões no topo.
2. Passo 2: Ao codificar, escolha "Codificar componente (encodeURIComponent)" para um único valor, ou "Codificar URL completa (encodeURI)" para um link completo.
3. Passo 3: Cole seu texto ou sua URL na caixa de entrada.
4. Passo 4: Clique em Codificar ou Decodificar e copie o resultado da caixa de saída.

O Codificador / decodificador de URL fica em Ferramentas para desenvolvedores. Abra a página da ferramenta, digite os seus dados no campo principal e os resultados se atualizam na hora. Use o botão de copiar para colar a saída em documentos, editores de código ou planilhas.

Casos de uso comuns

Codificar um valor de query

hello world & more vira hello%20world%20%26%20more

Codificar uma URL completa

https://example.com/a b?q=1 vira https://example.com/a%20b?q=1 com encodeURI

Decodificar uma URL codificada

https%3A%2F%2Fexample.com%2Fsearch é decodificado como https://example.com/search

Exemplos

• Codificar um valor de query: hello world & more vira hello%20world%20%26%20more
• Codificar uma URL completa: https://example.com/a b?q=1 vira https://example.com/a%20b?q=1 com encodeURI
• Decodificar uma URL codificada: https%3A%2F%2Fexample.com%2Fsearch é decodificado como https://example.com/search

Dicas de quem usa

• Teste primeiro com dados de exemplo quando o payload real for sensível.
• Se o processamento falhar, normalmente a entrada está malformada, não a ferramenta.
• Guarde uma versão minificada e uma legível: uma para publicar, outra para depurar.

Perguntas frequentes

O que é codificação de URL (percent-encoding)?

A codificação de URL, também chamada de percent-encoding, substitui caracteres inseguros ou reservados em uma URL por um % seguido de dois dígitos hexadecimais que representam o valor do byte. Por exemplo, um espaço vira %20 e um e comercial vira %26. Isso permite incluir com segurança espaços, símbolos e caracteres não ASCII em uma URL, em uma query string ou no envio de um formulário.

Qual é a diferença entre encodeURIComponent e encodeURI?

O encodeURIComponent escapa quase todos os caracteres reservados - incluindo & = ? / # : @ + e o espaço - então é a escolha certa para um único valor de query string ou segmento de caminho. O encodeURI deixa intactos os caracteres que formam a estrutura de uma URL (: / ? & = #), então serve para codificar uma URL completa que já contém esses delimitadores. Como regra: use encodeURIComponent para as partes e encodeURI para o todo.

Quais caracteres são codificados?

Caracteres não reservados (A-Z, a-z, 0-9 e - _ . ! ~ * ' ( )) nunca são codificados. Caracteres reservados e inseguros - espaços, &, =, ?, /, #, % e qualquer caractere não ASCII, como letras acentuadas ou emojis - são convertidos em um ou mais bytes %XX (UTF-8). O encodeURIComponent também codifica os delimitadores reservados, enquanto o encodeURI os preserva.

Como eu monto uma query string com segurança?

Codifique cada valor com encodeURIComponent antes de juntá-los com & e =. Por exemplo, `?q=` + encodeURIComponent('shoes & socks') produz `?q=shoes%20%26%20socks`. Isso evita que um valor que contenha &, = ou um espaço seja confundido com um delimitador e quebre a sua query string.

Por que recebo um erro ao decodificar?

A decodificação falha quando a entrada tem um escape de porcentagem mal formado - um "%" sozinho, sem dois dígitos hexadecimais depois, ou uma sequência inválida como "%zz". Confira se todo "%" é seguido por um código hexadecimal válido de dois dígitos. Texto que nunca foi codificado como URL passa sem alterações, a menos que contenha um "%" solto.

Meus dados são enviados para um servidor?

Não. Toda a codificação e a decodificação acontecem inteiramente no seu navegador, usando as funções padrão encodeURIComponent, encodeURI e decodeURIComponent. Nada do que você cola é enviado, registrado ou armazenado.

Ferramentas relacionadas que você pode precisar

Explore outras ferramentas para desenvolvedores no ToolsMinify. A página do Codificador / decodificador de URL tem links para utilitários relacionados, para você concluir o trabalho sem sair do site.