Codificação/Decodificação de URL
Codificar ou decodificar URLs e consultar strings
O que é URL Codificação?
A codificação de URL (também chamada de codificação percentual) converte caracteres especiais em um formato que pode ser transmitido com segurança em URLs. Como os URLs só podem conter um conjunto limitado de caracteres ASCII, qualquer caractere fora deste conjunto deve ser codificado como "%" seguido por dois dígitos hexadecimais representando o valor ASCII do caractere.
Por exemplo, um espaço se torna %20e o @
o símbolo se torna %40. Isso garante
Os URLs permanecem válidos e os caracteres especiais não interferem na estrutura do URL (como & e =
em strings de consulta).
Como usar esta ferramenta
Codificação vs. Encode Component
- Encode (encodeURI): Codifica um completo URL, preservando caracteres de URL válidos como :, /, ?, =, &
- Componente de codificação (encodeURIComponent): Codifica tudo, exceto letras, dígitos e - _ . ! ~ * ' ( ). Use isso para consulta valores de parâmetros.
- Decodificação: Converte strings codificadas por porcentagem voltar ao texto legível
Casos de uso comuns
🔗 Parâmetros de string de consulta
Ao passar a entrada do usuário por meio de parâmetros de URL, a codificação impede que caracteres especiais sejam quebrando a estrutura da URL. Por exemplo, "nome=John Doe&cidade=Nova York" precisa de codificação para espaços.
📧 Links de e-mail (mailto:)
Ao criar links mailto com linhas de assunto ou corpo de texto, caracteres especiais e os espaços devem ser codificados para funcionar corretamente em todos os clientes de e-mail.
🔐 API Solicitações
As APIs REST geralmente exigem que os valores dos parâmetros sejam codificados por URL, especialmente ao enviar JSON dados, tokens de autenticação ou consultas de pesquisa por meio de solicitações GET.
📊 Análise e rastreamento
Parâmetros UTM e códigos de rastreamento geralmente contêm valores codificados para garantir dados precisos transmissão sem erros de análise de URL.
Codificações de caracteres comuns
| Character | Encoded | Description |
|---|---|---|
| (space) | %20 or
+ |
Space character |
| & | %26 |
Ampersand |
| = | %3D |
Equals sign |
| ? | %3F |
Question mark |
| / | %2F |
Forward slash |
| @ | %40 |
At symbol |
| # | %23 |
Hash/pound |
| % | %25 |
Percent sign |
Perguntas frequentes
Qual é a diferença entre encodeURI e encodeURIComponent?
encodeURI()
codifica um URL completo, preservando caracteres como:, /, ?, e &. encodeURIComponent()
codifica tudo, tornando-o adequado para codificar valores de parâmetros de consulta individuais.
Devo usar %20 ou + para espaços?
Ambos representam espaços, mas %20 é a codificação de URL padrão enquanto + é específico para dados de formulário (aplicativo/x-www-form-urlencoded). Para strings de consulta, ambos funcionam, mas% 20 é mais universalmente compatível.
Meus dados estão seguros quando usando esta ferramenta?
Sim! Toda a codificação e decodificação acontece no seu navegador usando JavaScript. Seus dados nunca sai do seu dispositivo e nunca é enviado para nenhum servidor.
Por que recebo "Erro: URI malformado"?
Este erro ocorre ao tentar decodificar uma sequência codificada por porcentagem inválida. Certifique-se de que a entrada contém codificação válida (% seguida por exatamente dois dígitos hexadecimais).
Melhores práticas
- Sempre codifique a entrada do usuário antes de colocá-la em URLs
- Use encodeURIComponent para valores de parâmetros de consulta, encodeURI para URLs completos
- Decodifique URLs antes de exibi-los aos usuários para facilitar a leitura
- Seja consistente com a codificação em todo o seu aplicativo
- Teste URLs com caracteres especiais em diferentes navegadores