CONVERT.03 URL CODEC

Codificar / decodificar URL

Codifique uma URL inteira ou um parâmetro individual com sincronização nos dois sentidos e resultado instantâneo.

RAW

Texto original

ENC

Codificado

§ 01

Como codificar e decodificar URLs online

Digite o texto

Digite a URL original no editor esquerdo para codificá-la ou cole uma string codificada no editor direito para decodificá-la.

Escolha o modo

Marque “Preservar estrutura da URL” para usar encodeURI em links completos ou desmarque para usar encodeURIComponent em valores de parâmetros.

Copie o resultado

Clique no botão de copiar para enviar o resultado à área de transferência. A entrada em qualquer lado atualiza a conversão automaticamente.

§ 02

Sobre a codificação de URLs

Como funciona o percent-encoding

A codificação de URL é uma técnica essencial da web. URLs foram projetadas para aceitar letras, números e os símbolos seguros -_.~; por isso espaços, emojis e caracteres fora de ASCII são convertidos em % seguido de dois dígitos hexadecimais. Por exemplo, “你好” vira %E4%BD%A0%E5%A5%BD e um espaço vira %20.

Esta ferramenta oferece encodeURI para codificar uma URL completa sem alterar ://, /, ?, & e =, e encodeURIComponent para codificar integralmente um valor de parâmetro. O processamento acontece no navegador, sem upload para servidores.

Usos e princípio

Os caracteres A-Z, a-z, 0-9, -, _, . e ~ permanecem iguais. Os demais são convertidos em bytes UTF-8 e cada byte é escrito como %XX; a decodificação realiza o caminho inverso.

Use-a para parâmetros não ASCII no frontend, URLs de APIs REST durante a depuração, links de marketing com UTM, leitura de URLs em logs ou exportações do Google Analytics e links com caracteres especiais em e-mails HTML.

§ 03

Tabela de referência de codificação de caracteres

Caractere

Codificação URL

Descrição

Espaço

%20

Espaços precisam ser codificados em URLs

%21

Ponto de exclamação

%22

Aspas duplas

%23

Cerquilha, usada para identificar fragmentos

%24

Cifrão

%25

O próprio sinal de porcentagem também precisa ser codificado

%26

E comercial, separador de parâmetros

%2B

Sinal de mais; também pode indicar espaço em parâmetros

%2C

Vírgula

%2F

Barra; encodeURI preserva este caractere

%3A

Dois-pontos

%3D

Igual, separador de chave e valor

%3F

Interrogação, início da query string

%40

Arroba

你好

%E4%BD%A0%E5%A5%BD

Caracteres chineses convertidos em bytes UTF-8 e depois em %XX

😊

%F0%9F%98%8A

Emojis seguem a mesma regra de percent-encoding UTF-8

§ 04

Perguntas frequentes

Q1O que é codificação de URL (percent-encoding)?

É uma forma de representar caracteres especiais dentro de uma URL. Como URLs aceitam diretamente apenas letras, números e alguns símbolos, os demais caracteres são convertidos em % seguido de dois dígitos hexadecimais.

Q2O que faz “Preservar estrutura da URL”?

A opção deixa intactos caracteres estruturais como http://, /, ?, & e =, codificando somente texto como espaços e caracteres não ASCII. Ela é indicada para URLs completas.

Q3Por que aparece um erro ao decodificar?

Um % isolado, uma sequência que não tem dois dígitos hexadecimais ou bytes UTF-8 inválidos não obedecem às regras de percent-encoding e fazem o navegador retornar um erro. Confira a string inteira.

Q4Meus dados são enviados?

Não. Todos os dados são processados localmente no navegador e nenhuma informação do usuário é enviada ou salva.

Q5Qual é a diferença entre URL e Base64?

A codificação de URL mantém o endereço dentro do conjunto de caracteres permitido e gera sequências %XX. Base64 transforma dados binários em texto e é comum em anexos e Data URI; o resultado pode conter + e / que precisam de cuidado em URLs.

Q6Devo usar encodeURI ou encodeURIComponent?

Use encodeURI para uma URL inteira, preservando ://, / e ?; use encodeURIComponent para um valor de parâmetro. Por exemplo, encodeURI("https://example.com/busca?q=olá") mantém a estrutura, enquanto encodeURIComponent("olá mundo") codifica o espaço como %20.

Q7O aumento de tamanho afeta a velocidade de carregamento?

O impacto é quase sempre desprezível, geralmente de dezenas a centenas de bytes. Porém, navegadores e servidores costumam limitar URLs a cerca de 2048 caracteres, e uma URL próxima desse limite pode falhar após a codificação.

Q8Por que um espaço às vezes vira %20 e às vezes +?

Na query string, a especificação application/x-www-form-urlencoded permite + como representação do espaço. Em outras partes, como o caminho, é necessário usar %20. As APIs padrão de JavaScript usadas aqui sempre codificam espaços como %20.