Codificador e descodificador de entidades HTML

A codificação de entidades HTML transforma em referências textuais os caracteres que poderiam ser interpretados como marcação. A descodificação recupera os caracteres legíveis de um excerto já escapado. Escolha explicitamente a ação: um simples & num nome ou numa frase não indica o sentido pretendido. O resultado permanece texto num campo de saída, sem se tornar uma página HTML ativa. O processamento acontece no navegador e não envia o excerto para um serviço remoto de conversão.

A codificação substitui cinco caracteres: & por &amp;, < por &lt;, > por &gt;, aspas duplas por &quot; e apóstrofos por &#39;. Letras acentuadas, símbolos e emojis continuam a ser caracteres Unicode. É útil em vários contextos textuais HTML, mas não transforma cada carácter fora de ASCII numa referência com nome.

A descodificação reconhece referências HTML com nome e referências numéricas decimais ou hexadecimais. Algumas formas históricas sem ponto e vírgula seguem as regras de compatibilidade HTML; termine as referências com ponto e vírgula para obter entradas previsíveis. Sequências desconhecidas não são substituídas arbitrariamente. Texto literal e etiquetas existentes não são executados nem removidos.

Cada execução descodifica apenas uma camada. &amp;lt; torna-se &lt;, não diretamente <. Não são consumidos vários níveis de escape sem uma decisão explícita. Codificar uma entidade existente também protege o seu &: &lt; passa a &amp;lt;. Esta camada adicional pode ser necessária para documentar a escrita de uma entidade.

O escape depende do contexto de destino. Esta ferramenta não sanitiza documentos HTML nem protege, por si só, atributos URL, fragmentos JavaScript ou regras CSS. Texto descodificado pode tornar-se perigoso se outra aplicação o inserir depois através de innerHTML. Prefira inserção textual ou um sanitizador específico para conteúdo não fiável.