Blog

Como codificar um componente de URL e recuperar o texto original

Compare encodeURIComponent e encodeURI, decodifique no campo da direita e confira como a ferramenta trata espaços e sinais de mais.

A interface em inglês mostra a conversão de tea/cake em tea%2Fcake.
O exemplo usa a interface em inglês. Os controles ficam no mesmo lugar neste idioma.

Suponha que a busca seja por tea/cake. A barra faz parte do termo. Ela parece um separador de caminho de URL, mas a escolha do modo depende de preservar a barra ou convertê-la em %2F. Compare os modos em codificador e decodificador de URL. A conversão ocorre no navegador.

Codifique um componente de URL

  1. Abra a ferramenta e mude do modo padrão encodeURI para encodeURIComponent.
  2. Digite tea/cake no campo de entrada à esquerda.
  3. Clique em Codificar →. tea%2Fcake aparecerá à direita.
Com encodeURIComponent selecionado, tea/cake aparece à esquerda e tea%2Fcake à direita.
A barra vira %2F. Escolha o modo, digite o texto e clique em Encode.

tea%2Fcake pode entrar no URL como um único valor de busca. Se você passar todo o URL pronto para encodeURIComponent, os dois-pontos e as barras de https:// também serão codificados. Use encodeURI para preservar os separadores do URL completo. Esse modo também preserva a barra do termo de busca, por isso é preciso codificar o termo primeiro.

Decodifique no campo da direita

  1. Mantenha encodeURIComponent selecionado e confira se tea%2Fcake está no campo de saída à direita. Para decodificar outro texto, cole-o diretamente nesse campo.
  2. Clique em ← Decodificar.
  3. Confira se tea/cake aparece no campo de entrada à esquerda.
O botão Decode transforma tea%2Fcake, à direita, de volta em tea/cake, à esquerda.
A decodificação vai da direita para a esquerda. É possível decodificar o resultado sem clicar em Swap antes.

Copiar copia o campo da direita. Para aproveitar o texto recuperado à esquerda, selecione-o e copie manualmente. Para guardar em um arquivo, cole-o em um editor de texto e salve. A ferramenta não tem botão de download.

Verifique espaços e sinais de mais

Ative Converter espaços em + (compatível com application/x-www-form-urlencoded) para que %20 se torne + na codificação. Na decodificação, + só é tratado como espaço quando a opção está ativa. Antes de escolher a configuração, veja se o sinal de mais é literal ou representa um espaço.

Alterar o modo ou a caixa de seleção recodifica o texto à esquerda e atualiza o campo direito. Para examinar um texto já codificado, ajuste as opções antes de colá-lo à direita.

Uma sequência de escape % incompleta pode causar falha na decodificação. Se o campo de entrada ainda mostrar texto anterior, ele não é o resultado da tentativa atual. Veja se, no texto colado no campo de saída, cada % é seguido por dois dígitos hexadecimais. A codificação muda a representação do texto sem criptografá-lo. Quem receber o URL pode ler os valores nele, portanto não inclua informações secretas.