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 gratis para converter texto e links em percent-encoding (codificacao de URL) ou decodificar uma URL codificada de volta em texto legivel. Escolha entre encodeURIComponent - que escapa caracteres reservados como &, =, ? e / para que um valor seja seguro dentro de uma query string - ou encodeURI, que mantem intacta a estrutura de uma URL completa. A mesma pagina tem um construtor de query string: adicione pares chave/valor, opcionalmente uma URL base, copie o resultado, ou cole uma query ou URL para preencher os campos de volta. Tudo roda no lado do cliente, no seu navegador, entao nada e 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 ou decodifique URLs com percent-encoding, ou monte e analise query strings com pares chave/valor. encodeURIComponent, encodeURI e parse-back 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 / Decodificar para percent-codificar texto, ou Query string para montar e analisar parametros.
2. Passo 2: Ao codificar, deixe o interruptor de URL completa desligado para um unico valor (encodeURIComponent), ou ligue-o para um link completo (encodeURI).
3. Passo 3: No modo Query string, adicione linhas chave/valor (e uma URL base opcional). Cada valor e codificado com seguranca. Cole uma query ou URL e toque em Analisar nos campos para preencher as linhas.
4. Passo 4: Copie o texto codificado, decodificado ou a query gerada da caixa de saida.

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

Montar uma query string

Linhas q=sapatos & meias e sort=price viram ?q=sapatos%20%26%20meias&sort=price

Analisar uma URL de volta

https://example.com/search?q=ola%20mundo&page=2 preenche os campos q e page; + em dados de formulario vira espaco

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
• Montar uma query string: Linhas q=sapatos & meias e sort=price viram ?q=sapatos%20%26%20meias&sort=price
• Analisar uma URL de volta: https://example.com/search?q=ola%20mundo&page=2 preenche os campos q e page; + em dados de formulario vira espaco

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?

Mude para o modo Query string e adicione uma linha por parametro. O construtor codifica cada chave e valor com encodeURIComponent antes de junta-los com & e =, assim um valor como sapatos & meias vira sapatos%20%26%20meias e nao quebra a query. Voce tambem pode codificar um unico valor no modo Codificar / Decodificar e cola-lo voce mesmo.

Posso analisar uma query string ou URL de volta nos campos?

Sim. No modo Query string, cole uma query solta (?q=ola+mundo), um caminho com query ou uma URL completa e toque em Analisar nos campos. A ferramenta preenche as linhas chave/valor, trata + como espaco (form-urlencoded) e define a URL base quando voce cola um link completo. Escapes percentuais malformados mostram um erro claro.

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?

Nao. Toda a codificacao, decodificacao, montagem de query e parse-back acontecem inteiramente no seu navegador, usando as funcoes padrao encodeURIComponent, encodeURI e decodeURIComponent. Nada do que voce cola e 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.