URL Encode e Decode

URL encode, ou percent-encoding, é a técnica que substitui caracteres não permitidos em uma URL por um sinal de porcentagem seguido do código hexadecimal do byte. Por exemplo, o espaço vira %20 e a cedilha do ç vira %C3%A7 em UTF-8. Endereços web só aceitam um conjunto limitado de caracteres seguros; qualquer outro (espaço, acento, e comercial, interrogação, igual, barra) precisa ser escapado para não quebrar o link ou mudar o significado da URL. É uma codificação, não criptografia: o valor volta ao original ao decodificar.

O percent-encoding pega cada caractere que precisa ser escapado, converte para os seus bytes em UTF-8 e escreve cada byte como % seguido de dois dígitos hexadecimais. Letras, números e alguns sinais (hífen, sublinhado, ponto e til) passam sem alteração, pois são considerados seguros. Caracteres com acento ou emoji, que ocupam vários bytes em UTF-8, geram várias sequências de porcentagem seguidas. Ao decodificar, o processo é invertido: cada sequência volta a ser o byte correspondente e o conjunto é lido de novo como UTF-8, recuperando o texto exato.

A diferença está em quais caracteres cada função escapa. O encodeURIComponent, usado aqui, escapa também os separadores da URL como e comercial, igual, interrogação e barra, porque serve para codificar um valor individual, tipo o conteúdo de um parâmetro de busca. Já o encodeURI preserva esses separadores, pois é feito para tratar uma URL inteira já montada, sem quebrar a estrutura dela. Regra prática: use a codificação de componente para cada valor antes de encaixá-lo na query string, e nunca aplique a função de URL inteira a um valor solto que contenha e comercial ou igual.