Codificação URL

Sugestões Relacionadas

O que é codificação URL?

Casos de uso

• Depuração de parâmetros API: compara as saídas de encodeURIComponent e encodeURI para resolver problemas de incompatibilidade de assinatura de interface
• Decodificação de logs: decodifica em lote conteúdo codificado URL em logs para restaurar texto legível
• Construção de URL: modo Query Only preserva nomes de chaves e codifica apenas valores, evitando erros de formato por concatenação manual
• Desenvolvimento frontend: destaque ajuda a entender quais caracteres são escapados, útil para depurar redirecionamentos de página
• Migração de dados: processa em lote dados codificados URL exportados de sistemas legados para conversão para novo formato

Como Usar

1. Insira ou cole a URL ou texto a ser codificado/decodificado
2. Selecione a direção de codificação (Codificar/Decodificar) e o modo (Component / URI / full / RFC 3986)
3. Ative o modo em lote para dados multilinha, ou Query Only para codificar apenas valores de parâmetros
4. Verifique o resultado destacado e copie a string codificada para uso em solicitações API ou construção de URL

Recursos

• Quatro modos de codificação: troca com um clique entre encodeURIComponent / encodeURI / full / RFC 3986, comparação em tempo real das diferenças de saída
• Destaque de codificação: destaca em tempo real os caracteres %XX escapados, marcação âmbar torna os resultados da codificação visíveis de relance
• Modo em lote: suporte a codificação/decodificação multilinha em lote, cada linha é processada independentemente, ideal para logs ou dados em massa
• Modo Query Only: codifica apenas a parte do valor do parâmetro URL (após o sinal de igual), mantendo intactos os nomes das chaves, símbolos e estrutura do caminho
• Debounce em tempo real: codificação/decodificação automática em 300ms, sem necessidade de clicar em botões, resultados aparecem ao digitar
• Contagem de caracteres: exibe em tempo real o número de caracteres inseridos, prático para verificar limites de comprimento de parâmetros API

Exemplos de Código

// encodeURIComponent: codifica valores de parâmetros individuais (mais comum)
const param = encodeURIComponent('张三&李四');
console.log(param); // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

// encodeURI: codifica URL completa (preserva caracteres estruturais :/?#&=)
const url = encodeURI('https://example.com/search?q=olá mundo');
console.log(url);

// Decodificação
const decoded = decodeURIComponent(param);
console.log(decoded); // 张三&李四

// Compatível com RFC 3986 (~ não é codificado)
function rfc3986Encode(str) {
  return encodeURIComponent(str).replace(/[!'()*]/g, c => '%' + c.charCodeAt(0).toString(16).toUpperCase());
}

// API URLSearchParams (método moderno, codificação automática)
const params = new URLSearchParams({ name: '张三', city: '北京' });
console.log(params.toString());
// name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC

from urllib.parse import quote, unquote, urlencode, quote_plus

# quote: semelhante ao encodeURIComponent
encoded = quote('张三&李四')
print(encoded)  # %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

# Modo RFC 3986 (~ não é codificado, é o padrão)
print(quote('hello~world'))  # hello~world

# quote_plus: espaços são codificados como + (formato de formulário)
print(quote_plus('hello world'))  # hello+world

# Decodificação
print(unquote(encoded))  # 张三&李四

# urlencode: construir query string
params = urlencode({'name': '张三', 'city': '北京'})
print(params)
# name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC

import java.net.URLEncoder;
import java.net.URLDecoder;
import java.net.URI;
import java.nio.charset.StandardCharsets;

public class URLEncodeExample {
    public static void main(String[] args) throws Exception {
        // Codificação URL (URLEncoder é formato de formulário, espaços são +)
        String encoded = URLEncoder.encode("张三&李四", "UTF-8");
        System.out.println(encoded);
        // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

        // Decodificação
        String decoded = URLDecoder.decode(encoded, "UTF-8");
        System.out.println(decoded); // 张三&李四

        // Construir URL completa (classe URI trata codificação automaticamente)
        URI uri = new URI("https", "example.com", "/search", "q=olá", null);
        System.out.println(uri.toASCIIString());
    }
}

Perguntas frequentes

Glossário

Codificação por cento (Percent-encoding)

O nome oficial da codificação URL, um método de codificação que representa caracteres usando % seguido de dois dígitos hexadecimais. Por exemplo, espaço é codificado como %20, o caractere chinês '中' como %E4%B8%AD.Wikipedia - Codificação por cento

encodeURIComponent

Função integrada do JavaScript que codifica todos os caracteres exceto A-Z a-z 0-9 - _ . ! ~ * ' ( ). É mais comumente usada para codificar valores individuais de parâmetros de consulta URL.

encodeURI

Função integrada do JavaScript que preserva caracteres estruturais da URL (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) e codifica apenas os caracteres que realmente precisam ser codificados. É usada para codificar URLs completas.

RFC 3986

O padrão IETF mais recente para sintaxe genérica URI (2005), que define as regras de codificação URL e classifica o til ~ como caractere não reservado (não precisa de codificação). Substitui os antigos RFC 2396 e RFC 1738.RFC 3986

Caracteres reservados (Reserved Characters)

Caracteres com significado especial em URLs, como : / ? # [ ] @ ! $ & ' ( ) * + , ; =. Esses caracteres devem ser codificados quando usados como dados, mas não em suas posições estruturais.

Caracteres não reservados (Unreserved Characters)

Caracteres seguros que podem ser usados em qualquer posição na URL sem codificação, incluindo A-Z, a-z, 0-9, -, _, ., ~ (conforme RFC 3986).

Query String

A parte da URL após ?, composta por pares key=value separados por &. Por exemplo, em ?name=张三&age=20, name=张三 e age=20 são dois parâmetros.

URLSearchParams

API fornecida por navegadores modernos para construir e analisar facilmente query strings URL, com tratamento automático de codificação e decodificação. Mais segura e confiável que concatenação manual de strings.

application/x-www-form-urlencoded

O formato de envio padrão de formulários HTML, onde espaços são codificados como + em vez de %20, ligeiramente diferente de encodeURIComponent. Frameworks do lado do servidor geralmente tratam ambos os formatos automaticamente.

Codificação UTF-8

A codificação de caracteres padrão da Web. Na codificação URL, caracteres não ASCII (como chinês, emoji) são primeiro convertidos para sequências de bytes UTF-8, depois cada byte é codificado no formato %XX.

Comparação de escape de caracteres em 4 modos de codificação

Referência rápida de caracteres reservados URL comuns

Authoritative References

• ReferenceRFC 3986 - Identificador Uniforme de Recursos (URI): Sintaxe Genérica
• ReferenceRFC 1738 - Localizadores Uniformes de Recursos (URL)
• ReferenceMDN Web Docs - encodeURIComponent()
• ReferenceMDN Web Docs - encodeURI()
• ReferenceWikipedia - Codificação por cento