Texto e código / MULTIVERTO

Codificador de componente de URL

Codifique em UTF-8 uma única parte de URL, como valor de parâmetro ou segmento de caminho.

Conversor interativoSua entrada permanece neste navegador. Nenhum texto é enviado para conversão.

Texto para codificar

Valor codificado em porcentagem

Abrir arquivo localO arquivo permanece no seu navegador.

Conversão em lote

Insira um valor por linha.Resultados em lote

Encadear ferramentas

Aplique cada ferramenta de texto ao resultado anterior. Fluxos de trabalho com texto ↗

Escolha a próxima ferramenta

Nome da sequência

Sequências salvas

Somente o nome da sequência e a ordem das ferramentas são salvos neste navegador. Sua entrada e seus resultados nunca são salvos.

01 / Exemplo

Exemplo

Sua entradaSão Paulo & região

ResultadoS%C3%A3o%20Paulo%20%26%20regi%C3%A3o

02 / Guia

Codificador de componente de URL — Como funciona

O que esta ferramenta recebe?

Uma URL contém partes com funções diferentes: esquema, host, caminho, consulta e, às vezes, fragmento. Este codificador foi feito para o conteúdo de uma parte, como o valor de um parâmetro de consulta ou um segmento de caminho. Alguns caracteres têm função estrutural na URL; o ampersand pode separar parâmetros, e o sinal de igual pode separar nome e valor. Se esses sinais pertencem aos dados do usuário, precisam ser representados de outra forma para não mudar a estrutura do endereço. A codificação percentual escreve bytes como % seguido de dois dígitos hexadecimais. O texto é primeiro convertido em UTF-8.

Exemplo com espaços e acentos

Imagine uma busca cujo valor é “São Paulo & região”. Aplicando o codificador ao valor, o espaço vira %20, o ampersand vira %26 e o ã é representado pelos seus bytes UTF-8, não por um único código da letra. Depois, acrescente o resultado a um parâmetro já definido, por exemplo após “q=”. Se você codificar “q=São Paulo & região” de uma vez, também escapará o sinal de igual que deveria separar a chave do valor. Faça a operação uma vez por componente. Ao receber a URL, o servidor deve decodificar o componente para recuperar exatamente a sequência de caracteres pretendida.

Diferença entre formatos parecidos

Em dados de formulário do tipo application/x-www-form-urlencoded, um espaço pode ser representado por “+”; na codificação de componente usada aqui, ele aparece como %20. Um sinal de mais literal no dado exige cuidado especial em sistemas que interpretam “+” como espaço. Caminhos, valores de consulta e fragmentos ainda podem ter regras ou convenções distintas na aplicação de destino. Por isso, use uma API de construção de URL apropriada quando estiver montando endereços completos em código. Em JavaScript, URLSearchParams monta parâmetros de consulta e representa espaços de valores pelas regras de formulários; não confunda essa saída com a codificação de um componente exibida aqui. Esta página ajuda a inspecionar uma peça do endereço e a perceber por que caracteres reservados não podem ser copiados livremente para a consulta.

Erros frequentes e conferência

A dupla codificação é comum: se o texto já contém %20 e for codificado outra vez, o sinal de porcentagem vira %25, produzindo %2520. Um único passo de decodificação então devolve “%20”, não um espaço. Para verificar a ida e volta, decodifique o valor final como um componente e compare com a entrada original, incluindo acentos, espaços finais e quebras de linha. Não trate a codificação como validação de segurança de um link; um destino externo ainda pode ser inadequado. Evite colocar segredos em parâmetros, pois URLs podem aparecer em histórico, registros e mensagens. E nunca interprete a saída percentual como uma URL completa sem recolocar seus separadores de propósito.

Como esta conversão transforma a entrada

Texto a codificar

Codificação de porcentagem UTF-8

Valor porcentagem-codificado