Codificador / decodificador de URL

Guias relacionadas

• O que é codificação 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?

Mude para o modo Query string e adicione uma linha por parametro. O construtor codifica cada chave e valor com encodeURIComponent antes de junta-los com & e =, assim um valor como sapatos & meias vira sapatos%20%26%20meias e nao quebra a query. Voce tambem pode codificar um unico valor no modo Codificar / Decodificar e cola-lo voce mesmo.

Posso analisar uma query string ou URL de volta nos campos?

Sim. No modo Query string, cole uma query solta (?q=ola+mundo), um caminho com query ou uma URL completa e toque em Analisar nos campos. A ferramenta preenche as linhas chave/valor, trata + como espaco (form-urlencoded) e define a URL base quando voce cola um link completo. Escapes percentuais malformados mostram um erro claro.

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?

Nao. Toda a codificacao, decodificacao, montagem de query e parse-back acontecem inteiramente no seu navegador, usando as funcoes padrao encodeURIComponent, encodeURI e decodeURIComponent. Nada do que voce cola e enviado, registrado ou armazenado.

Ferramentas relacionadas