O processamento de textos para transmissão em endereços web ou para exibição em documentos estruturados exige transformações específicas para evitar conflitos de sintaxe. A ferramenta "Codificador/Decodificador de URL + Entidades HTML" realiza a conversão de textos por meio de codificação e decodificação para URLs, bem como o escape e desescape de entidades HTML.
Toda a operação de conversão ocorre diretamente no navegador do leitor, o que significa que nenhum dado ou texto de URL e HTML é enviado para o BroBroGo.
O propósito da codificação e decodificação de URL
As URLs são projetadas para aceitar apenas um conjunto restrito de caracteres da tabela ASCII. Caracteres especiais, espaços e símbolos de outros alfabetos precisam ser transformados em um formato universalmente aceito pelos servidores e navegadores. Esse processo é conhecido como codificação percentual (percent-encoding).
A codificação substitui caracteres não permitidos por um caractere % seguido por dois dígitos hexadecimais que representam o valor do byte em UTF-8. Por exemplo, o espaço em branco é convertido em %20. Na decodificação, o processo é inverso: as sequências de escape percentuais são interpretadas e transformadas de volta no caractere original legível.
Diferença entre componente de URL e URL completa
Ao codificar ou decodificar dados para a web, é fundamental selecionar o escopo correto da operação. A ferramenta oferece duas opções de escopo que utilizam funções nativas distintas:
- Componente (usando
encodeURIComponent/decodeURIComponent): Este modo é indicado para tratar valores de consulta (query values), partes de caminhos (path pieces) ou valores de formulários. Ele codifica quase todos os caracteres não alfanuméricos, incluindo:,/,?,&e=, garantindo que esses delimitadores não quebrem a estrutura da URL principal onde o componente será inserido. - URL completa (usando
encodeURI/decodeURI): Este modo é aplicado quando se deseja codificar um endereço web inteiro, mantendo legíveis os caracteres estruturais como:,/,?,&e=. Ele garante que o endereço continue funcionando como uma URL válida após a conversão.
O controle de escopo da URL fica oculto na interface quando o modo de Entidades HTML está selecionado.
Entidades HTML: Escapar e desescapar
A linguagem HTML utiliza caracteres específicos, como < e >, para definir a sua estrutura de tags. Se um texto comum inserido na página contiver esses caracteres, o navegador poderá interpretá-los incorretamente como código, quebrando o layout ou impedindo a exibição correta do conteúdo.
O escape de entidades HTML resolve esse problema ao transformar caracteres como <, >, &, aspas e textos não-ASCII em suas respectivas entidades nomeadas ou numéricas. Isso torna o texto seguro para ser colado diretamente em blocos de texto ou atributos HTML. O processo de desescape realiza o caminho inverso, convertendo as entidades de volta para os caracteres originais de exibição.
É importante destacar que o escape de entidades HTML e a codificação de URLs servem para garantir a integridade da exibição e transmissão dos dados, diferenciando-se de processos de sanitização de segurança focados em barrar scripts maliciosos.
Regras de conversão e tratamento de erros
A ferramenta possui limites operacionais e regras estritas para garantir a precisão das conversões:
- Limite de tamanho: O limite máximo para o processamento é de 2.000.000 de caracteres na entrada. Caso o texto inserido ultrapasse esse limite, a ferramenta exibirá a mensagem: "Essa entrada é longa demais para esta ferramenta. Mantenha-a com menos de
{max}caracteres.". - Sequências de escape corrompidas: Durante a decodificação de URLs, os escapes percentuais devem representar sequências UTF-8 completas. Uma sequência incompleta ou quebrada, como
%E0%A4%A, não pode ser decodificada, gerando o erro: "Este texto de URL possui uma sequência de escape com porcentagem corrompida.". - Ausência de dados: Se o usuário tentar realizar uma conversão sem inserir texto, a ferramenta exibirá o aviso: "Cole alguma entrada primeiro.".
- Tempo limite e falhas gerais: Se o processo demorar além do esperado, a mensagem "Esta conversão está demorando muito. Tente uma entrada menor." será exibida. Para falhas indefinidas, o sistema reportará: "Não foi possível converter esta entrada.".
Exemplos práticos de conversão
Os exemplos abaixo ilustram o comportamento do sistema para diferentes tipos de entrada e saída:
| Modo de Operação | Entrada de Exemplo | Saída Esperada |
|---|---|---|
| Codificação de URL | hello world & city=上海 |
hello%20world%20%26%20city%3D%E4%B8%8A%E6%B5%B7 |
| Decodificação de URL | hello%20world%20%26%20city%3D%E4%B8%8A%E6%B5%B7 |
hello world & city=上海 |
| Escape de HTML | 保存 |
保存 |
| Desescape de HTML | <button title="Save & close">保存</button> |
<button title="Save & close">保存</button> |
Perguntas Frequentes
Devo escolher componente de URL ou URL completa?
Use "Componente" para valores de consulta (query values), partes de caminhos ou valores de formulários. Use "URL completa" quando quiser manter legíveis caracteres como :, /, ?, & e =.
O que a codificação de entidades HTML altera?
Ela transforma caracteres como <, >, &, aspas e textos não-ASCII em entidades que podem ser coladas com segurança em textos ou atributos HTML.
Por que a decodificação de URL às vezes falha?
As sequências de escape com porcentagem devem ser sequências UTF-8 completas. Uma sequência corrompida como %E0%A4%A não pode ser decodificada sem adivinhação.
Onde ocorre o processamento dos dados convertidos?
Seu texto de URL e HTML é convertido no seu navegador. Nada é enviado para o BroBroGo, garantindo que as informações não saiam do seu dispositivo local durante o uso.