Como descodificar texto codificado em URL

Quando usar esta ferramenta

Esta ferramenta torna legível texto que usa percent encoding, uma forma de representar determinados caracteres através de sequências iniciadas pelo sinal de percentagem. É adequada quando já dispõe de uma cadeia e quer observar o conteúdo depois da descodificação, sem alterar manualmente cada código.

A entrada é feita numa área de texto e é opcional, sem uma lista de opções predefinidas. Entre as representações tratadas encontram-se códigos para espaços, para o símbolo “&” e para o sinal “=”. Depois da primeira passagem, a ferramenta realiza outra passagem e informa se o texto sofreu uma alteração nessa fase.

Essa indicação adicional é útil para perceber se a cadeia pode conter mais do que uma camada de codificação. Deve, contudo, comparar as versões apresentadas antes de escolher o conteúdo que vai reutilizar, sobretudo quando a cadeia foi transformada por etapas sucessivas. O ponto de partida é sempre o texto que fornecer na área de entrada, e não um endereço cujo conteúdo tenha de ser obtido.

Como tratar uma cadeia

1. Na área de texto, introduza ou cole a cadeia que pretende analisar. Preserve os sinais de percentagem e os códigos associados, como %20, %26 e %3D, pois são esses elementos que representam os caracteres a descodificar.

2. Confirme visualmente o conteúdo antes de iniciar. Pode inserir uma frase, uma cadeia extensa ou texto com vários códigos percentuais; a ferramenta trata o conteúdo escrito no campo e não exige que escolha uma opção numa lista.

3. Acione o controlo disponível para começar o tratamento. A primeira passagem converte as codificações percentuais reconhecidas e prepara o texto descodificado para ser consultado no resultado.

4. Leia a versão produzida nessa primeira passagem e procure a indicação relativa à segunda. Essa informação mostra se o tratamento adicional modificou o texto já descodificado, mas não escolhe por si só qual versão deve utilizar.

5. Se houver uma alteração, compare as duas fases e volte à cadeia original para confirmar o contexto. Quando precisar de analisar outra entrada, substitua o conteúdo da área de texto e execute novamente a operação. Manter o original disponível facilita a comparação entre as versões.

Como ler o que é apresentado

Comece por separar o texto da primeira passagem da informação sobre a passagem seguinte. A primeira versão corresponde ao resultado da descodificação inicial; a indicação adicional esclarece se uma nova passagem mudou esse resultado.

Se não tiver sido observada uma mudança na segunda passagem, a cadeia não apresentou uma alteração nessa fase. Se tiver ocorrido uma mudança, examine as duas versões antes de prosseguir, porque a diferença pode indicar que a entrada incluía uma camada adicional de codificação.

A ferramenta trabalha sobre o texto fornecido. Não deve ser usada para obter o conteúdo de um endereço nem para confirmar se um endereço está corretamente formado, porque a sua função descrita é descodificar a cadeia recebida. Se surgir uma exceção durante o tratamento, o resultado mantém o estado de sucesso e inclui uma indicação de erro; reveja então o conteúdo introduzido em vez de interpretar essa indicação como texto descodificado.

Uma entrada vazia segue uma condição própria: o resultado também é bem-sucedido, mas assinala que não foi fornecido texto. Para obter uma análise útil, preencha a área de texto com a cadeia pretendida e repita o tratamento.

Exemplo prático

Precisa de tornar legível uma cadeia em que um espaço, um “&” e um “=” foram representados por percent encoding antes de a consultar.

Cole hello%20world%20%26%20foo%3Dbar na área de texto e submeta o conteúdo para tratamento. Esta cadeia contém representações percentuais de um espaço, do símbolo “&” e do sinal “=” . O valor indicado como entrada predefinida corresponde a esta mesma cadeia quando não é fornecido outro texto.

O resultado apresenta uma versão descodificada da cadeia e uma indicação que permite saber se a segunda passagem alterou essa versão. A forma concreta da indicação deve ser lida no próprio resultado.

Limitações

• A análise incide apenas sobre a cadeia introduzida; não substitui a obtenção de conteúdo a partir de um endereço nem a confirmação da estrutura desse endereço.

Erros comuns

• Deixar a área de texto vazia produz um resultado bem-sucedido com uma indicação de que não foi fornecido texto. Introduza a cadeia que pretende descodificar e execute novamente o tratamento.

Perguntas frequentes

O que faz esta ferramenta?

A ferramenta descodifica o texto percent-encoded que fornecer e mostra o resultado inicial. Também informa se uma segunda passagem provocou uma alteração, permitindo distinguir as duas fases do tratamento.

O que acontece se deixar o campo vazio?

Quando não introduz texto, a operação continua a apresentar um resultado bem-sucedido, mas inclui uma indicação de que falta conteúdo. Preencha a área de texto com a cadeia que deseja analisar e volte a iniciar o tratamento.

Como são apresentados os problemas durante a descodificação?

Se ocorrer uma exceção durante a descodificação, o resultado conserva o estado bem-sucedido e inclui uma indicação de erro. Reveja a cadeia fornecida antes de tirar conclusões sobre o conteúdo apresentado.