Como codificar e descodificar entidades HTML

Envie o texto e escolha o modo encode para aplicar o escape HTML; para texto não vazio, um modo com outro valor segue a descodificação. Se o texto estiver vazio, a resposta é bem-sucedida sem aplicar nenhuma das duas operações.

O que pode fazer com a ferramenta

Esta ferramenta permite transformar texto com entidades HTML em dois sentidos: pode aplicar a operação de escape ao codificar ou desfazer essa transformação ao descodificar. É útil quando precisa de preparar texto para um contexto HTML ou de interpretar texto que já contém entidades, sem ter de alternar entre ferramentas diferentes.

O funcionamento depende de dois dados de entrada: o texto e o modo. O texto pode ser deixado vazio, e o modo assume encode quando não é indicado. A distinção entre os modos é literal, por isso convém confirmar o valor enviado antes de interpretar o resultado.

Como codificar ou descodificar entidades HTML

1. Introduza o texto. Cole ou escreva o conteúdo no campo de texto. Se não fornecer texto, a ferramenta considera a entrada vazia.

2. Escolha o modo. Para codificar, utilize exatamente o valor encode. Para descodificar texto não vazio, utilize um valor diferente de encode. Neste segundo caso, a ferramenta segue o percurso de descodificação.

3. Execute a transformação. Submeta os dados com o texto e o modo selecionado. Se não indicar o modo, é usado encode por predefinição.

4. Leia a resposta. Verifique o texto transformado e o modo devolvido. Quando a entrada contém texto, encode aplica a operação de escape HTML; um modo com outro valor aplica a operação de unescape HTML.

5. Confirme o caso vazio. Se o texto estiver vazio, a ferramenta termina com sucesso e devolve texto transformado vazio juntamente com o modo fornecido. Nesse caso, não aplica a operação de codificação nem a de descodificação. Esta exceção é importante quando os campos são preenchidos automaticamente ou quando o conteúdo é opcional.

Como interpretar o resultado

A resposta deve ser lida em função do modo e do conteúdo enviado. Com texto não vazio e o modo exatamente encode, o resultado corresponde à operação de escape HTML. Com texto não vazio e um modo diferente de encode, o resultado corresponde à operação de unescape HTML. Assim, não basta verificar se foi escolhido um modo de descodificação: confirme o valor efetivamente transmitido.

O modo também faz parte da resposta, o que ajuda a conferir a operação solicitada. No caso de texto vazio, o sucesso da resposta não significa que tenha ocorrido uma transformação; significa que foi devolvido texto transformado vazio e o modo fornecido.

A ferramenta tem um contrato que declara não utilizar acesso à rede. Essa informação descreve a comunicação da ferramenta, mas não permite concluir como um ambiente concreto gere armazenamento, contas ou confidencialidade. Evite tratar uma resposta bem-sucedida como prova de cobertura de todas as entidades HTML ou de uma conversão garantidamente reversível.

Exemplo prático

Uma pessoa prepara o texto A & B para uma utilização que requer a operação de escape HTML.

Envie o texto A & B com o modo exatamente encode e verifique o texto transformado e o modo devolvido.

A resposta contém texto transformado e o modo encode; o texto transformado resulta da operação de escape HTML.

Limitações

• O contrato declara ausência de acesso à rede, mas não estabelece garantias sobre armazenamento, confidencialidade, cobertura de entidades HTML ou reversibilidade dos resultados.

Erros comuns

• Usar uma palavra diferente de encode e esperar codificação: para texto não vazio, esse valor segue a operação de unescape HTML. Para codificar, envie exatamente encode.

Perguntas frequentes

Qual é o modo predefinido?

O modo predefinido é encode quando não envia um modo. Com texto não vazio, esse valor aplica o escape HTML.

Como descodifico entidades HTML?

Para texto não vazio, utilize um valor diferente de encode; esse percurso aplica o unescape HTML. Se o texto estiver vazio, nenhuma operação é aplicada.

O que acontece se eu não fornecer texto?

Sim, a resposta pode ser bem-sucedida com texto vazio, mas o texto transformado permanece vazio e o modo fornecido é devolvido sem codificação ou descodificação.