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

É um método de representar caracteres que não são permitidos diretamente em uma URL — como espaços, &, ?, # e caracteres não ASCII — como um sinal de porcentagem seguido de dois dígitos hexadecimais representando o valor em byte do caractere, por exemplo um espaço vira %20.

Quando preciso codificar texto em URL?

Sempre que estiver construindo uma URL, query string ou envio de formulário que inclua texto gerado pelo usuário, caracteres especiais ou texto não inglês. Buscas, URLs de redirecionamento e parâmetros de API passados em uma URL comumente precisam de codificação.

Qual a diferença entre encodeURIComponent e encodeURI?

encodeURIComponent (usado por esta ferramenta) codifica todo caractere que não é seguro dentro de um único componente de URL, como o valor de um parâmetro de query, incluindo &, = e /. encodeURI é destinado a codificar uma URL inteira e deixa esses caracteres estruturais intactos. Use encodeURIComponent ao codificar um valor que vai dentro de uma query string.

Por que a decodificação às vezes mostra um erro?

A decodificação falha quando a entrada contém uma sequência percent-encoded malformada — por exemplo, um '%' não seguido por dois dígitos hexadecimais válidos, ou uma sequência que não forma bytes UTF-8 válidos. Esta ferramenta captura esse URIError e exibe uma mensagem clara em vez de travar.

Isso lida corretamente com espaços?

Sim. Um espaço é codificado como %20 pelo encodeURIComponent (a forma correta para um caminho de URL ou valor de query). Note que envios de formulário HTML usando application/x-www-form-urlencoded tradicionalmente usam '+' para espaços — essa é uma convenção distinta que esta ferramenta não replica.

Esta ferramenta lida com emojis e texto não latino?

Sim. encodeURIComponent primeiro codifica o texto em UTF-8, depois aplica percent-encoding a cada byte resultante, então emojis, chinês, árabe e outro texto Unicode são convertidos corretamente ao codificar e decodificar.

Meus dados são enviados a um servidor ao usar esta ferramenta?

Não. Tanto a codificação quanto a decodificação rodam inteiramente em JavaScript dentro da aba do seu navegador usando APIs nativas. Nenhuma solicitação de rede é feita.

O que são 'caracteres reservados' em uma URL?

Caracteres como : / ? # [ ] @ ! $ & ' ( ) * + , ; = têm significado especial na sintaxe de URL (separando o esquema, caminho, query e fragmento). encodeURIComponent escapa esses caracteres para que sejam tratados como dados literais em vez de sintaxe estrutural de URL quando colocados dentro de um componente como um valor de query.

Por que minha URL codificada é muito mais longa que o texto original?

Todo caractere fora do pequeno conjunto 'não reservado' (letras, dígitos, - _ . ~) é substituído por uma sequência %XX de 3 caracteres por byte UTF-8. Texto com muitos espaços, símbolos ou caracteres não ASCII pode se expandir significativamente.

Posso usar isso para codificar uma URL completa, não só um parâmetro de query?

Esta ferramenta é baseada em encodeURIComponent, destinada a codificar componentes individuais de URL (como o valor de um único parâmetro de query), não uma URL completa com sua estrutura de esquema e caminho — codificar uma URL completa dessa forma também escaparia os caracteres ':' e '/' que precisam permanecer literais.

Codificador e Decodificador de URL — Codifique ou Decodifique URLs Instantaneamente

Nosso Codificador / Decodificador de URL converte texto de e para percent-encoding (o formato %XX usado em URLs e query strings) usando as funções nativas encodeURIComponent e decodeURIComponent do navegador. Alterne entre o modo Codificar e Decodificar, digite ou cole seu texto, e veja o resultado ser atualizado instantaneamente. Sequências percent-encoded malformadas ao decodificar são detectadas e informadas com clareza em vez de travar a página. Tudo acontece localmente — o texto nunca é enviado a um servidor.

Texto para codificar

Resultado

Seu resultado aparecerá aqui

Como usar Codificador / Decodificador de URL — Ferramenta Gratuita de Percent-Encoding

1
Escolha Codificar para aplicar percent-encoding em texto para uso seguro em uma URL, ou Decodificar para converter uma string percent-encoded de volta em texto simples.
2
Cole ou digite sua entrada na área de texto.
3
O resultado aparece instantaneamente conforme você digita — sem necessidade de clicar em botão.
4
Clique em 'Copiar' para copiar o resultado codificado ou decodificado para a área de transferência.

Por que usar Codificador / Decodificador de URL — Ferramenta Gratuita de Percent-Encoding?

URLs só podem conter com segurança um conjunto limitado de caracteres — letras, dígitos e alguns sinais de pontuação. Espaços, ecomerciais, pontos de interrogação e caracteres não ASCII como letras acentuadas ou emojis precisam ser percent-encoded (representados como %XX, onde XX é o valor hexadecimal do byte do caractere) antes de poderem ser incluídos com segurança em um caminho de URL, query string ou envio de formulário. Sem a codificação correta, URLs quebram, parâmetros de query são truncados em caracteres '&' ou '=' não escapados, e texto não ASCII fica corrompido. Esta ferramenta usa a função nativa encodeURIComponent do JavaScript, que codifica corretamente texto Unicode em UTF-8 antes de aplicar percent-encoding, e decodeURIComponent, que reverte o processo. Decodificar uma string percent-encoded malformada (como um '%' solitário não seguido por dois dígitos hexadecimais) normalmente lança um URIError — esta ferramenta captura isso e mostra um erro legível em vez de travar.

Perguntas frequentes

Ferramentas relacionadas

Codificador / Decodificador Base64 — Ferramenta Gratuita

Codifique texto em Base64 ou decodifique Base64 de volta em texto simples instantaneamente no seu navegador. Suporta UTF-8 e Unicode corretamente. Grátis, sem cadastro, sem envio de dados a um servidor.

Formatador e Validador de JSON — Beautifier Gratuito Online

Formate e valide JSON com indentação adequada, ou minifique para economizar espaço. Detecta erros de sintaxe instantaneamente com uma mensagem clara. Grátis, sem cadastro, roda totalmente no seu navegador.

Testador de Regex — Ferramenta Gratuita de Expressão Regular Online

Teste expressões regulares em texto de exemplo com destaque de correspondências ao vivo, grupos de captura e suporte a flags (g, i, m, s, u). Grátis, sem cadastro, roda totalmente no seu navegador.