Descodificador de URL

Como usar o Descodificador de URL

1. Cole um URL com codificação percentual, um valor de consulta ou outro texto codificado no campo URL codificado. O valor predefinido está disponível se quiser experimentar primeiro um exemplo.
2. Leia o texto convertido em URL descodificado. Pode copiar o resultado com o controlo de cópia ao lado.
3. Se o resultado indicar Cadeia codificada inválida, verifique se a entrada contém uma sequência percentual incompleta, um escape não hexadecimal ou uma sequência de bytes UTF-8 inválida.

O que significa descodificar um URL

A codificação percentual representa um carácter com um sinal de percentagem seguido de dois algarismos hexadecimais por cada byte codificado. Permite que os URLs transportem caracteres que, de outra forma, teriam um significado especial ou seriam difíceis de incluir diretamente. Um espaço escreve-se habitualmente como %20; dois pontos podem escrever-se como %3A. Este descodificador transforma essas sequências de volta em caracteres legíveis, facilitando a inspeção de links copiados, destinos de redirecionamento e valores de consulta.

A calculadora aplica decodeURIComponent a todo o texto que fornecer. Apesar do nome do campo, a entrada não tem de ser um URL completo: Hello%20World%21 produz Hello World!. Também descodifica caracteres reservados com codificação percentual. No exemplo resolvido, %3F torna-se o ponto de interrogação que inicia uma cadeia de consulta e %3D torna-se o sinal de igual no respetivo parâmetro.

O texto descodificado é útil para ler um valor, mas não é necessariamente um URL que deva usar sem alterações. Uma barra, um ponto de interrogação ou um «e» comercial descodificados podem assumir um papel estrutural se o resultado for colocado novamente num URL. Se precisar de codificar texto outra vez para um determinado componente de URL, use o Codificador de URL. Para encontrar links dentro de um corpo de texto maior, experimente o Extrator de URL.

Codificações comuns num relance

A última linha mostra um carácter codificado como vários bytes UTF-8. O descodificador interpreta sequências UTF-8 válidas com codificação percentual em conjunto, em vez de tratar cada byte codificado como um carácter separado.

Limites e dicas práticas

Um sinal de adição não é convertido num espaço por esta calculadora. Em dados de consulta com codificação de formulário, + representa frequentemente um espaço, mas decodeURIComponent deixa-o como +. Por exemplo, red+blue mantém-se red+blue, enquanto red%20blue se torna red blue. Se estiver a processar dados de formulário, use um analisador de consultas que reconheça formulários para distinguir essa convenção da descodificação percentual.

A descodificação acontece apenas uma vez. Por exemplo, %2520 torna-se %20, e não um espaço: a primeira passagem descodifica %25 num sinal de percentagem literal. Descodifique uma segunda vez apenas se souber que a fonte foi codificada duas vezes. Descodificações repetidas podem alterar o significado de texto que pretendia manter literal.

Cada sinal de percentagem deve iniciar um escape válido, como %2F. Um % isolado, um escape como %ZZ ou bytes com codificação percentual que não formam UTF-8 válido fazem com que a calculadora mostre Cadeia codificada inválida em vez de um resultado parcial. A calculadora remove os espaços em branco à volta da entrada antes de descodificar, mas os espaços representados por %20 dentro da entrada permanecem no resultado descodificado.

A descodificação de URL é diferente da descodificação de Base64: os dois formatos usam regras diferentes e não são intercambiáveis. Se o texto que tem for Base64 em vez de codificação percentual, use o Descodificador de Base64.