Codificador e decodificador de URL

Operação
Escopo da codificação

O modo componente também codifica separadores de URL. O modo URI completa preserva separadores reservados. O sinal de mais não é tratado como espaço.

O texto é processado no seu dispositivo, sem envio nem armazenamento. Copiar coloca o resultado na área de transferência do sistema.

Sobre esta ferramenta

Esta ferramenta aplica codificação percentual a textos para uso seguro em URLs e decodifica textos com escapes percentuais de volta para caracteres legíveis, incluindo Unicode. Desenvolvedores, profissionais de marketing e analistas a usam para montar query strings, depurar links ou ler parâmetros de rastreamento codificados. A codificação percentual substitui um caractere por um sinal de porcentagem seguido de dois dígitos hexadecimais para cada byte UTF-8, então um espaço vira %20.

Como funciona

Escolha Codificar ou Decodificar e depois o escopo. O modo componente serve para uma única parte da URL, como um valor de consulta ou um segmento do caminho, e escapa todos os caracteres reservados. O modo URI completa serve para um endereço inteiro e mantém separadores como barra, dois-pontos, ponto de interrogação e e comercial, preservando a estrutura da URL.

Cole o texto e o resultado é atualizado enquanto você digita; copie-o quando estiver certo. A ferramenta só transforma o texto e nunca abre nem acessa a URL. Se a decodificação falhar, procure um sinal de porcentagem solto ou um escape incompleto, porque uma única sequência malformada interrompe a conversão inteira.

Exemplo

No modo componente, hello world vira hello%20world, e a&b vira a%26b. Um valor de busca com acento e pontuação, café & tea?, vira caf%C3%A9%20%26%20tea%3F: o é se transforma em dois escapes UTF-8, o e comercial vira %26 e o ponto de interrogação vira %3F. O sinal de porcentagem literal também é escapado, então 50% off vira 50%25%20off.

O escopo faz diferença na hora de montar links. Codificar https://example.com/search?q=café & tea no modo URI completa dá https://example.com/search?q=caf%C3%A9%20&%20tea, em que o e comercial fica sem escape e divide o valor em um segundo parâmetro. Codifique só o valor no modo componente e depois acrescente-o após q=. Decodificar %E2%82%AC10 retorna €10.

Premissas e limites

A ferramenta segue a codificação de URI padrão do JavaScript e aceita até 100.000 caracteres. Ela não converte sinais de mais em espaços como fazem os formulários HTML, não verifica se uma URL funciona, não separa query strings em parâmetros e não faz conversões de Base64, entidades HTML ou punycode. Escapes percentuais malformados são rejeitados em vez de decodificados parcialmente.

Perguntas frequentes

Por que o sinal de mais permanece igual?

Esta ferramenta usa codificação percentual de URI, e não codificação de formulário HTML. Ela não troca sinais de mais por espaços, e os espaços são codificados como %20. Se o texto veio de um formulário enviado ou de uma query string montada com application/x-www-form-urlencoded, substitua cada + por um espaço antes de decodificar aqui.

Por que a decodificação falha?

Cada escape percentual precisa conter dois dígitos hexadecimais e representar UTF-8 válido. Escapes incompletos como %2, um sinal de porcentagem solto como em 100% ou sequências de bytes que não formam UTF-8 válido são rejeitados, em vez de decodificados pela metade. Corrija ou codifique o trecho problemático e tente de novo.

Qual a diferença entre codificar como componente e como URI completa?

O modo componente também codifica caracteres reservados como /, ?, &, = e #, para que um valor não quebre a estrutura da URL. O modo URI completa mantém esses separadores e codifica apenas os caracteres que não são permitidos em uma URL, como espaços e letras fora do ASCII. Use o modo componente para valores que você insere e o modo URI completa só para um endereço que já está com a estrutura correta.

Por que caracteres acentuados viram vários escapes?

Cada caractere é primeiro convertido em bytes UTF-8, e cada byte vira um escape. Por exemplo, é usa dois bytes e é codificado como %C3%A9, enquanto o símbolo do euro usa três e vira %E2%82%AC. Letras, dígitos e alguns sinais como - _ . ~ não precisam de escape e ficam como estão.

Devo codificar a URL inteira ou só os valores dos parâmetros?

Codifique cada valor separadamente no modo componente e depois junte as partes com os separadores desejados. Codificar uma URL pronta como componente também escaparia o :// e as barras, gerando um endereço que os navegadores não conseguem abrir. O modo URI completa só é seguro para ajustar uma URL cuja estrutura já está correta, por exemplo uma que tenha espaços ou letras acentuadas no caminho.

Link com os seus valores

Adicione estes parâmetros ao endereço desta página para abri-la com os valores já preenchidos, por exemplo para compartilhar um cálculo ou criar um link a partir de um assistente de IA. O resultado é calculado no navegador: o HTML da página mostra um exemplo com os valores padrão, e a ferramenta define o atributo data-url-params quando os valores do link são aplicados.

ParâmetroValorSe omitido
modeOperaçãoum destes: encode, decodepadrão: encode
scopeEscopo da codificaçãoum destes: component, uripadrão: component
textTexto de entradanão aceito em links: digite na página

Exemplos

  • ?mode=decode
  • ?mode=encode&scope=uri

Escreva decimais com ponto. Codifique um espaço como %20, + como %2B, # como %23 e & como %26.

Elementos do resultado: [data-result-block="url-codec"]