Codificar e decodificar entidades HTML

Codificar e decodificar entidades HTMLUsos e orientação prática

Entidades HTML representam caracteres com um papel na marcação. Codificar muda sinais como menos de, maior que, ampersand e aspas em referências que podem aparecer como texto em um contexto adequado. Ajuda a preparar um exemplo de código ou inspecionar uma string recebida de outro sistema. A decodificação recupera caracteres de entidades reconhecidas, mas não transforma o conteúdo fornecido em uma página executável dentro dessa ferramenta. A saída permanece texto para inspeção.

Verifique se a codificação ou decodificação é necessária primeiro. Codificar um fragmento já contendo entidades pode adicionar outra camada de representação em torno de seus ampersands. A decodificação executa uma passagem: uma representação aninhada pode reter outra camada na saída. Isso torna o conteúdo real de cada nível visível ao invés de interpretar repetidamente uma string até que ela se pareça com uma marcação. Conheça a representação esperada pelo destino antes de aplicar outra transformação.

A ferramenta aceita entidades terminadas ponto e vírgula, incluindo referências nomeadas e valores numéricos de Unicode. Referências desconhecidas permanecem inalteradas. Teste símbolos especiais de uma amostra real para confirmar a aparição dos caracteres esperados. A codificação HTML difere da codificação de URL e do Base64; cada um segue regras separadas e é apropriado somente quando o sistema receptor espera essa representação. Cordas escapadas de aparência semelhante não podem ser substituídas livremente entre esses contextos.

Escapar de uma corda aqui não garante que cada inserção posterior seja segura. Texto HTML, atributos, JavaScript e URLs têm contextos diferentes. Em um aplicativo, use mecanismos de modelo apropriados e evite a inserção descontrolada de dados como marcação executável. O conversor exibe seu resultado como texto. Retenha a fonte e inspecione como a cópia é usada em seu sistema final, especialmente quando os caracteres também servem como separadores estruturais ou limites de citação.

Uma verificação prática antes de usar o resultado

Para um exemplo de marcação visível, use uma tag curta e confirme se a saída codificada mantém seu significado textual. Inclua um ampersand já pertencente a uma entidade para observar outra camada de codificação. Depois de decodificar, distinguir um personagem recuperado de uma instrução para executá-lo: saída aqui permanece texto. Teste o contexto de inserção específico ao colocar a cópia em uma página. Uma entidade apropriada para texto HTML não processa automaticamente um valor dentro do JavaScript ou de um URL. Mantenha a amostra e o contexto de destino para que outra pessoa possa repetir a verificação e entender a representação escolhida. O teste específico de contexto é mais informativo do que simplesmente observar que o conversor retornou uma string sem erro.