Codificador / decodificador de URL

Perguntas frequentes sobre o Codificador / decodificador de URL

O que é codificação de URL (percent-encoding)?

A codificação de URL, também chamada de percent-encoding, substitui caracteres inseguros ou reservados em uma URL por um % seguido de dois dígitos hexadecimais que representam o valor do byte. Por exemplo, um espaço vira %20 e um e comercial vira %26. Isso permite incluir com segurança espaços, símbolos e caracteres não ASCII em uma URL, em uma query string ou no envio de um formulário.

Qual é a diferença entre encodeURIComponent e encodeURI?

O encodeURIComponent escapa quase todos os caracteres reservados - incluindo & = ? / # : @ + e o espaço - então é a escolha certa para um único valor de query string ou segmento de caminho. O encodeURI deixa intactos os caracteres que formam a estrutura de uma URL (: / ? & = #), então serve para codificar uma URL completa que já contém esses delimitadores. Como regra: use encodeURIComponent para as partes e encodeURI para o todo.

Quais caracteres são codificados?

Caracteres não reservados (A-Z, a-z, 0-9 e - _ . ! ~ * ' ( )) nunca são codificados. Caracteres reservados e inseguros - espaços, &, =, ?, /, #, % e qualquer caractere não ASCII, como letras acentuadas ou emojis - são convertidos em um ou mais bytes %XX (UTF-8). O encodeURIComponent também codifica os delimitadores reservados, enquanto o encodeURI os preserva.

Como eu monto uma query string com segurança?

Codifique cada valor com encodeURIComponent antes de juntá-los com & e =. Por exemplo, `?q=` + encodeURIComponent('shoes & socks') produz `?q=shoes%20%26%20socks`. Isso evita que um valor que contenha &, = ou um espaço seja confundido com um delimitador e quebre a sua query string.

Por que recebo um erro ao decodificar?

A decodificação falha quando a entrada tem um escape de porcentagem mal formado - um "%" sozinho, sem dois dígitos hexadecimais depois, ou uma sequência inválida como "%zz". Confira se todo "%" é seguido por um código hexadecimal válido de dois dígitos. Texto que nunca foi codificado como URL passa sem alterações, a menos que contenha um "%" solto.

Meus dados são enviados para um servidor?

Não. Toda a codificação e a decodificação acontecem inteiramente no seu navegador, usando as funções padrão encodeURIComponent, encodeURI e decodeURIComponent. Nada do que você cola é enviado, registrado ou armazenado.

Ferramentas relacionadas