Codificar URL

Codifica texto no formato de URL.

Resultado codificado para URL

Exemplos de uso

Incluir caracteres especiais em um parâmetro de consulta

Um termo de busca ou valor com &, =, espaços ou caracteres não ASCII pode quebrar uma query string. Codificá-lo primeiro mantém a URL intacta.

Incorporar uma mensagem em um link de compartilhamento

Quando você precisa colocar texto livre em uma URL — um link de compartilhamento social, um parâmetro de assunto de e-mail —, codificá-lo primeiro evita que o link quebre.

Usar um nome de arquivo não ASCII em um caminho de URL

Se um nome de arquivo com espaços ou caracteres não ASCII precisar aparecer como parte de um caminho de URL, usar o valor codificado é a abordagem segura.

Montar uma URL de redirecionamento com um caminho de retorno

Um fluxo de login que redireciona de volta para ?returnTo=/dashboard?tab=billing precisa que a URL interna seja codificada primeiro; caso contrário, seus próprios ? e & são interpretados como parte da query string externa.

Gerar um link mailto: com assunto e corpo preenchidos

Um link mailto:user@example.com?subject=...&body=... quebra se o assunto ou o corpo contiver &, # ou quebras de linha. Codificar cada valor mantém o link clicável.

Passar um blob JSON por um parâmetro GET

Algumas APIs aceitam pequenos objetos de filtro como ?filter={"status":"active"} na query string. As chaves, as aspas e os dois-pontos precisam ser codificados para sobreviver como um único parâmetro.

Referência rápida

ASCII punctuation & space

CharacterEncoded
U+0020%20
!!
"%22
#%23
$%24
%%25
&%26
''
((
))
**
+%2B
,%2C
/%2F
:%3A
;%3B
<%3C
=%3D
>%3E
?%3F
@%40
[%5B
\%5C
]%5D
^%5E
`%60
{%7B
|%7C
}%7D
~~

Non-ASCII & control characters

CharacterEncoded
U+000A%0A
U+0009%09
é%C3%A9
ñ%C3%B1
ü%C3%BC
€%E2%82%AC
£%C2%A3
©%C2%A9
—%E2%80%94
한%ED%95%9C
日%E6%97%A5
😀%F0%9F%98%80

Perguntas frequentes

O texto que eu digito é enviado para um servidor?

Não. A codificação acontece inteiramente no seu navegador, e o que você digita nunca é enviado a um servidor.

Posso colar uma URL inteira aqui?

Esta ferramenta usa encodeURIComponent. Codificar uma URL inteira (incluindo https://...) também codificaria delimitadores como :, / e ?, deixando de ser uma URL válida. Use isto para um valor que vai DENTRO de uma URL — um valor de parâmetro de consulta ou um segmento de caminho —, não para uma URL completa.

Como os espaços são tratados?

Os espaços são codificados como %20. (A convenção + é uma regra diferente usada especificamente para envios de dados de formulário, então esta ferramenta não a usa.)

Isso funciona com texto em outros idiomas e emojis?

Sim. Os caracteres são codificados em porcentagem com base em seus bytes UTF-8, então caracteres não ingleses, emojis e outros textos Unicode são tratados corretamente.

Qual é a diferença entre encodeURIComponent e encodeURI?

O encodeURI (não usado aqui) presume que você está passando uma URL completa, então deixa intactos os delimitadores reservados, como :, /, ?, # e &. O encodeURIComponent, que esta ferramenta usa, presume que você está passando um único valor que pertence ao interior de uma URL, então também codifica esses caracteres delimitadores. É por isso que esta ferramenta não é adequada para codificar uma URL completa.

Quais caracteres são deixados sem codificação?

De acordo com o conjunto não reservado da RFC 3986, o encodeURIComponent deixa A-Z, a-z, 0-9 e - _ . ~ intactos. Todos os outros caracteres, incluindo delimitadores reservados como : / ? # [ ] @ ! $ & ' ( ) * + , ; =, são codificados com porcentagem.

Por que o + às vezes significa espaço e às vezes um sinal de mais literal?

Depende do contexto. Em dados application/x-www-form-urlencoded (envios clássicos de formulários HTML), o + representa um espaço. Em um URI padrão conforme a RFC 3986 — que é o que esta ferramenta produz — o + é apenas um caractere de mais literal, e um espaço é sempre %20. Misturar as duas convenções é uma fonte comum de bugs.

A codificação de URL é o mesmo que criptografia ou hash?

Não. A codificação com porcentagem é totalmente reversível, sem nenhuma chave envolvida — qualquer pessoa pode decodificá-la de volta ao texto original na hora. Ela existe apenas para tornar o texto seguro para ser transmitido dentro de uma URL, não para ocultar ou proteger o seu conteúdo.