Codificador e decodificador de entidades HTML nomeadas

Converta textos de e para entidades HTML nomeadas sem instalar pacotes nem depender do DOM do navegador. O modo de codificação protege caracteres sensíveis à marcação, como e comercial, sinais de menor e maior, aspas e apóstrofos, além de símbolos e sinais tipográficos comuns. O modo de decodificação restaura entidades reconhecidas e rejeita nomes desconhecidos, em vez de preservar silenciosamente um provável erro.

Codifique o texto antes de inseri-lo em HTML

Use o modo de codificação quando um texto simples precisar ser representado com segurança no código HTML. Um e comercial pode iniciar uma referência de entidade, os sinais de menor e maior podem ser interpretados como tags e as aspas podem interferir na sintaxe ao redor do valor. O conversor substitui os caracteres compatíveis por referências nomeadas como <code>&amp;amp;</code>, <code>&amp;lt;</code>, <code>&amp;gt;</code>, <code>&amp;quot;</code> e <code>&amp;apos;</code>.

Ele também reconhece caracteres frequentes de moeda, propriedade intelectual, matemática, pontuação e espaçamento, entre eles copyright, marca registrada, euro, espaço não separável, travessões, aspas curvas, marcadores e reticências. A codificação ocorre em uma única passagem, portanto os caracteres introduzidos pela conversão não são codificados novamente. Letras, números, espaços, emojis e caracteres não contemplados permanecem iguais.

Vale lembrar que a codificação de entidades representa texto, mas não é um sanitizador HTML completo: ela não valida documentos, não remove tags perigosas e não determina se um valor é seguro em contextos JavaScript, CSS ou URL.

Decodifique entidades com validação rigorosa

Escolha o modo de decodificação quando a entrada contiver referências nomeadas e você precisar dos caracteres originais para exibição, comparação, indexação, exportação ou processamento. Cada referência completa, formada por e comercial, nome e ponto e vírgula, é consultada na tabela fixa da capacidade. As formas reconhecidas são substituídas pelos caracteres Unicode correspondentes, sem alterar o restante do texto.

Os nomes diferenciam maiúsculas de minúsculas, pois capitalizações distintas podem ter significados diferentes em HTML. Essa rejeição rigorosa é útil em automações: um erro como <code>&amp;copry;</code> não passa despercebido para aparecer depois como texto quebrado. Um e comercial isolado, sem nome e ponto e vírgula no formato de entidade, permanece intacto.

Esta capacidade trata apenas de entidades nomeadas; referências numéricas decimais e hexadecimais estão fora do contrato. Como o mapeamento é fixo, o resultado não depende da versão do navegador, de pacote externo, rede ou localidade.

Escolha o modo e integre o resultado

Envie dois campos: <code>text</code> contém a string de origem e <code>mode</code> deve ser <code>encode</code> ou <code>decode</code>. Os dois são obrigatórios para que nenhuma integração precise adivinhar o sentido da conversão. A resposta devolve o <code>text</code> convertido e o <code>mode</code> aplicado, deixando registros e fluxos de trabalho fáceis de interpretar.

Em um fluxo de codificação, envie o conteúdo escrito por pessoas antes de incorporá-lo à marcação e armazene ou transmita o resultado. Em um fluxo de decodificação, considere uma entidade desconhecida uma falha de validação e corrija o sistema produtor em vez de suprimir o erro. O algoritmo não usa rede, aleatoriedade, datas nem estado retido, por isso é adequado para testes de referência e geração reproduzível.

Em sistemas maiores, mantenha a conversão em uma fronteira clara: codifique ao entrar em uma representação HTML e decodifique somente ao sair dela. Alternar repetidamente os modos dificulta identificar quem controla o escape e pode incentivar dupla codificação acidental.