Codificar e decodificar URL

Codifique texto para um valor de URL, decodifique sequências de escape ou monte uma consulta com pares de chave e valor editáveis.

Modo de conversão

Importe um arquivo, cole ou digite

TXTCSVJSONXML
0 na entrada 0 na saída 0%
Chave Valor

Nenhum parâmetro ainda

Use Adicionar para criar o primeiro par de chave e valor
Digite uma URL base e adicione parâmetros para ver o resultado

Tabela de caracteres de URL

Representações com porcentagem de caracteres comuns. Codifique os caracteres reservados quando fizerem parte de um valor, e não da estrutura da URL. Este codificador mantém !, os parênteses, * e ~ sem alterações.

Clique em um valor para copiá-lo.

CaractereDescriçãoCodificado
Espaço
!Ponto de exclamação
"Aspas duplas
)Parêntese de fechamento
,Vírgula
;Ponto e vírgula
[Colchete de abertura
}Chave de fechamento
^Acento circunflexo
?Ponto de interrogação
#Cerquilha
'Apóstrofo
*Asterisco
CaractereDescriçãoCodificado
/Barra
=Sinal de igual
]Colchete de fechamento
|Barra vertical
`Acento grave
&E comercial
%Porcentagem
(Parêntese de abertura
+Sinal de mais
:Dois-pontos
@Arroba
{Chave de abertura
\Barra invertida
~Til

Suas estatísticas

0
Total de caracteres
0
Bytes codificados
0
Caracteres especiais
0
Caracteres Unicode
0%
Variação do comprimento
Sim
Sintaxe de caracteres de URI

Como codificar ou decodificar valores de URL

Guias

O vídeo mostra a interface em inglês.

Escolha Codificar URL e digite o texto. Espaços e outros caracteres especiais viram sequências com porcentagem. Por exemplo, tea & coffee se torna tea%20%26%20coffee. Use essa opção para um valor que precise de codificação e confira os requisitos do destino.

Codificação de URL e parâmetros de consulta

Codificar um componente de URL

Converta espaços, sinais &, barras e texto não ASCII em valores codificados com porcentagem. A codificação usa encodeURIComponent e também escapa apóstrofos. Se você inserir uma URL completa, os caracteres que compõem sua estrutura também serão codificados.

Recuperar o texto original

Decodifique sequências com porcentagem e interprete sinais de mais como espaços. Uma sequência malformada deixa a linha correspondente sem alterações, para que você possa verificá-la antes de tentar novamente.

Converter várias linhas

Digite um item por linha para converter uma lista. Quando há várias linhas, as vazias são ignoradas e os espaços nas extremidades das demais são removidos antes do processamento.

Mostrar mais 3Mostrar menos

Montar parâmetros de consulta

Adicione, duplique ou exclua linhas e escolha se cada chave e valor devem ser codificados. Ordenar alterna entre A a Z, Z a A e a ordem anterior. Remover duplicatas mantém a última linha de cada chave exata.

Extrair parâmetros de uma URL

Uma URL absoluta válida com uma consulta, inserida no campo de conversão, fornece os parâmetros decodificados para o construtor. A URL base é reconstruída com a origem e o caminho, sem o fragmento original.

Copiar ou exportar um relatório

Copie apenas o resultado convertido ou use Copiar texto para incluir a entrada e o resultado. Os relatórios TXT e JSON incluem os dados e as estatísticas da conversão. O construtor permite copiar separadamente a URL gerada.

Perguntas frequentes

O que é codificação percentual de URL?

A codificação percentual representa cada byte com % seguido de dois dígitos hexadecimais. Um espaço vira %20. O texto não ASCII é codificado como bytes UTF-8, por isso um caractere pode gerar várias sequências com porcentagem.

Quando devo codificar um valor de URL?

Use Codificar quando caracteres como & ou = fizerem parte do valor, e não da estrutura da URL. Por exemplo, codifique um termo de busca antes de colocá-lo depois de q=. No construtor, a opção Codificar aplica essa conversão à chave e ao valor de cada linha.

A ferramenta usa encodeURI ou encodeURIComponent?

Ela usa encodeURIComponent e também substitui apóstrofos por %27. Essa codificação escapa separadores como /, ?, & e =. Use-a para um componente ou valor de parâmetro. Codificar uma URL completa aqui gera um valor escapado, e não um endereço navegável que mantenha a estrutura original.

O que acontece com espaços e sinais de mais?

Ao codificar, espaços viram %20 e sinais de mais viram %2B. Ao decodificar, cada + é tratado como espaço antes de processar as sequências com porcentagem, como nos valores de consulta de um formulário. Para manter um sinal de mais literal, use %2B em vez de +.

Mostrar mais 6Mostrar menos

Codificar uma URL é o mesmo que criptografá-la?

Não. A codificação percentual muda a representação do texto, e qualquer pessoa pode decodificá-lo. Ela não esconde o valor nem protege tokens, senhas ou outros segredos.

O que acontece com sequências com porcentagem inválidas?

Se a decodificação falhar, a linha correspondente fica sem alterações. Por exemplo, %ZZ não é uma sequência válida. Quando há várias linhas, as outras que forem válidas ainda podem ser decodificadas. Confira o resultado: um texto que não mudou não comprova que a conversão deu certo.

Como funciona a conversão de várias linhas?

Cada linha não vazia é processada separadamente. Os espaços nas extremidades são removidos e as linhas vazias são ignoradas. Se houver apenas uma linha, seus espaços iniciais e finais são mantidos e viram sequências com porcentagem na codificação.

O que Remover duplicatas faz no construtor?

Mantém a última linha de cada chave exata e remove as linhas sem chave. Letras maiúsculas e minúsculas diferenciam as chaves. Uma API pode aceitar chaves repetidas, por isso use essa ação apenas quando quiser manter um único valor por chave.

As URLs são enviadas a um servidor para codificação?

A codificação, a decodificação e a montagem de consultas acontecem no navegador. O código de processamento não envia o texto a um serviço de codificação. O link compartilhado inclui a entrada no fragmento da URL, então qualquer pessoa que o receber poderá lê-la.

Por que a tabela de caracteres nem sempre corresponde ao resultado?

A tabela mostra representações com porcentagem que os caracteres podem ter. Este codificador mantém !, os parênteses, * e ~ sem alterações, mas escapa explicitamente o apóstrofo como %27. Confira o resultado real para saber como a ferramenta representa um valor.

Detalhes técnicos

Codificação e decodificação

A codificação chama encodeURIComponent e substitui apóstrofos por %27. A decodificação primeiro troca sinais de mais por espaços e depois chama decodeURIComponent. Se uma sequência for inválida, a linha original é devolvida. Essas operações transformam texto. Elas não o criptografam nem garantem que uma URL completa tenha o significado pretendido.

Linhas e contagens de caracteres

Quando há várias linhas, as vazias são removidas e os espaços nas extremidades das demais são cortados. As contagens rápidas de entrada e saída usam o comprimento da string do JavaScript, enquanto a análise conta pontos de código Unicode. As sequências com porcentagem representam bytes codificados no resultado, por isso sua quantidade não corresponde à de caracteres originais.

Mostrar mais 2Mostrar menos

Montagem de consultas

O construtor acrescenta pares de chave e valor ao texto base, usando & quando ele já contém ?. Os parâmetros são inseridos antes de um fragmento existente. A codificação é escolhida por linha. Ordenar compara as chaves conforme a localidade e permite recuperar a ordem anterior. Remover duplicatas compara chaves exatas e mantém seu último valor. A extração de parâmetros do texto de conversão usa URL e URLSearchParams.

Processamento no navegador e relatórios

Arquivos importados são lidos como texto e processados localmente. Os relatórios TXT e JSON incluem a entrada, o resultado e as estatísticas. O construtor oferece Copiar URL, mas não uma exportação de arquivo própria. As estatísticas locais podem ser salvas quando o armazenamento do navegador está disponível.