HTML Entities — Codificar e decodificar entidades HTML

O que o HTML Entities faz

O HTML Entities codifica caracteres que têm significado especial em HTML e decodifica referências de entidades de volta para texto legível. É útil ao preparar exemplos para documentação, escrever fixtures de teste para lógica de escape, inspecionar a saída de um CMS, limpar trechos copiados ou converter texto visível em uma forma que possa aparecer com segurança no código-fonte HTML. O codificador cobre e comerciais, colchetes angulares, aspas, apóstrofos e caracteres não ASCII com entidades numéricas quando apropriado. O decodificador oferece suporte a entidades nomeadas reconhecidas pelo navegador, como amp, lt, gt, quot, apos, copy, nbsp e muitas outras, por meio do próprio analisador de HTML do navegador.

Trechos reais costumam misturar entidades nomeadas com referências numéricas decimais ou hexadecimais geradas por templates, editores, feeds e sistemas legados. Esta ferramenta facilita a passagem entre o texto visível e a forma de código-fonte sem precisar escrever um script descartável. O botão de troca permite enviar a saída de volta para o modo oposto ao verificar conversões de ida e volta.

Fluxo de trabalho privado no navegador

Todo o processamento acontece dentro do seu navegador com JavaScript no lado do cliente. A ferramenta não envia a nenhum servidor trechos, valores de configuração, dados gerados, texto de consultas ou exemplos copiados e não exige conta. Esse modelo exclusivamente local é importante em utilitários para desenvolvedores, porque o conteúdo colado neles costuma parecer dados reais de aplicações: respostas de API, logs, exemplos com formato de variáveis de ambiente, consultas de banco de dados, marcação de rascunhos ou valores copiados de sessões de depuração em produção. Manter a transformação local reduz o risco e mantém a interação rápida, pois não há ida e volta pela rede.

A interface é propositalmente compacta para que você possa colar a entrada, ajustar as opções, inspecionar a saída, copiá-la e voltar ao seu editor. Ainda assim, os resultados devem ser revisados antes de serem commitados, compartilhados publicamente ou usados em um fluxo de produção. Ferramentas de navegador são excelentes para inspeção e preparação rápidas, mas não conseguem entender todas as convenções de um projeto, regras de classificação de dados ou requisitos de validação específicos de uma aplicação.

Dicas práticas

A codificação de entidades não é, por si só, um sanitizador de segurança completo. Use-a como transformação de texto para exemplos, testes e verificações simples de escape, não como substituta do escape do framework, das APIs do DOM, da política de segurança de conteúdo ou de um sanitizador confiável ao renderizar HTML não confiável. O contexto importa: escapar para um nó de texto HTML é diferente de escapar para atributos, URLs, strings JavaScript e CSS. Ao decodificar, lembre-se de que a saída pode voltar a conter colchetes angulares ou aspas reais, portanto revise-a antes de colá-la em uma página ou template.