Codificador e Decodificador de URL

Como Usar o Codificador e Decodificador de URL

Digite ou cole qualquer texto no campo de entrada e clique em Codificar para convertê-lo para o formato codificado de URL. A ferramenta fornece dois formatos de saída simultaneamente: Codificação por Componente usa o equivalente ao encodeURIComponent() do JavaScript, que codifica todos os caracteres especiais incluindo delimitadores de URL como /, ? e #. URL Completa Codificada usa o equivalente ao encodeURI(), que preserva os caracteres estruturais da URL enquanto codifica todo o resto. Para reverter o processo, cole texto codificado no campo de entrada e clique em Decodificar. Ambos os campos de saída mostrarão o mesmo resultado decodificado.

A grade de estatísticas abaixo da saída mostra o comprimento de caracteres e o tamanho em bytes tanto da entrada quanto da saída, ajudando você a entender como a codificação afeta o tamanho dos dados. Cada campo de saída tem seu próprio botão Copiar para acesso rápido à área de transferência. Esta ferramenta funciona inteiramente no seu navegador, sem dados enviados a nenhum servidor.

O Que É Codificação de URL?

A codificação de URL, formalmente conhecida como codificação percentual, é definida na RFC 3986 como o mecanismo para representar caracteres em um Identificador Uniforme de Recurso (URI) que não são permitidos na sintaxe da URI. URLs podem conter apenas um conjunto limitado de caracteres ASCII: letras, dígitos e um punhado de caracteres especiais (- _ . ~) conhecidos como caracteres não reservados. Qualquer outro caractere deve ser codificado como um sinal de porcentagem seguido por dois dígitos hexadecimais representando seu valor em bytes. Por exemplo, um espaço é codificado como %20, um "e" comercial como %26 e um sinal de mais como %2B.

Caracteres reservados como : / ? # [ ] @ ! $ & ' ( ) * + , ; = têm significado estrutural especial em URLs. Quando esses caracteres aparecem como dados em vez de delimitadores, eles devem ser codificados com porcentagem. Por exemplo, se uma consulta de busca contiver um "e" comercial, ele deve ser codificado como %26 para não ser interpretado como um separador de parâmetros.

encodeURIComponent vs encodeURI

O JavaScript fornece duas funções nativas para codificação de URL, cada uma servindo a um propósito diferente. encodeURIComponent() codifica todos os caracteres exceto caracteres não reservados (A-Z, a-z, 0-9, - _ . ~). Isso o torna ideal para codificar componentes individuais de URL, como valores de parâmetros de consulta, segmentos de caminho ou identificadores de fragmento. Ele codifica caracteres como / ? # & = porque esses quebrariam a estrutura se deixados sem codificação dentro de um valor de componente.

encodeURI() codifica uma URI completa preservando os caracteres que dão à URL sua estrutura: : / ? # [ ] @ ! $ & ' ( ) * + , ; =. Use-o quando você tem uma URL completa que pode conter caracteres não-ASCII (como letras acentuadas ou espaços no caminho) mas cujos delimitadores estruturais devem permanecer intactos. Por exemplo, encodeURI("https://example.com/caminho com espaços") codifica corretamente apenas os espaços enquanto mantém os delimitadores :// e /.

Espaços: + vs %20

O tratamento de espaços em URLs tem duas convenções. O padrão de codificação percentual (RFC 3986) codifica espaços como %20, e esta é a codificação correta para segmentos de caminho e identificadores de fragmento. O formato application/x-www-form-urlencoded, usado por formulários HTML ao enviar dados via GET ou POST, codifica espaços como +. Este formato é definido na especificação HTML e é o que os navegadores usam ao serializar dados de formulário em strings de consulta. Tanto %20 quanto + são representações válidas de um espaço, mas pertencem a contextos diferentes. Ao construir URLs programaticamente, prefira %20 para consistência com a RFC 3986.

Casos de Uso Comuns

A codificação de URL é essencial em muitos cenários de desenvolvimento web. Ao construir URLs com parâmetros de consulta dinâmicos, cada valor de parâmetro deve ser codificado para evitar que caracteres especiais quebrem a estrutura da URL. Requisições de API frequentemente requerem codificação de valores de parâmetros, especialmente ao transmitir conteúdo gerado pelo usuário, termos de busca ou nomes de arquivo. URLs de redirecionamento incorporadas como parâmetros de consulta devem ser totalmente codificadas para que todo o alvo de redirecionamento seja tratado como um único valor. Dados de formulários enviados em requisições GET são automaticamente codificados para URL pelos navegadores, mas o código do lado do servidor frequentemente precisa codificar valores ao construir URLs para redirecionamentos, chamadas de API ou geração de links.

Outro cenário comum é codificar dados para uso em URIs data:, bookmarklets e atribuições de location.href do JavaScript. A codificação também é crítica ao construir assinaturas OAuth, URLs assinadas por HMAC e qualquer manipulação de URL sensível à segurança onde a codificação incorreta pode levar a incompatibilidades de assinatura ou vulnerabilidades de injeção.

Perguntas Frequentes

O que é codificação de URL?

A codificação de URL (codificação percentual) converte caracteres não permitidos em URLs em um sinal de porcentagem seguido por dois dígitos hexadecimais. Espaços se tornam %20, "e" comerciais se tornam %26.

Qual é a diferença entre encodeURI e encodeURIComponent?

encodeURI preserva caracteres estruturais de URL como :, /, ? e #. encodeURIComponent codifica tudo exceto caracteres não reservados, tornando-o adequado para codificar valores individuais de parâmetros de consulta.

Por que os espaços são codificados como + ou %20?

O formato application/x-www-form-urlencoded usa + para espaços em envios de formulários. O padrão RFC 3986 usa %20. Ambos são válidos em contextos diferentes.

Quando devo codificar texto para URL?

Sempre que você incluir entrada do usuário ou caracteres especiais em parâmetros de consulta, segmentos de caminho ou identificadores de fragmento. Isso evita que caracteres como & e = sejam interpretados como delimitadores de URL.

Posso codificar uma URL inteira?

Não. Codificar uma URL inteira escaparia caracteres estruturais como :// e / tornando a URL inválida. Codifique apenas componentes individuais como valores de parâmetros e segmentos de caminho.