JSON Escape e Unescape

Como usar JSON Escape e Unescape

Quando você incorpora texto em um valor JSON, certos caracteres precisam de sequências de escape para não romper o documento. A especificação ECMA-404 define quais: aspas duplas devem ser precedidas de barra invertida, a própria barra invertida é duplicada, e caracteres de controle como quebra de linha, retorno de carro e tabulação ganham representações específicas de dois caracteres. Caracteres Unicode fora do ASCII básico de controle podem ser representados com a notação de quatro dígitos hexadecimais.

O bug mais comum aparece ao construir JSON manualmente por concatenação de strings. O texto funciona normalmente até que o usuário digita uma aspas dupla, uma barra invertida ou um emoji fora do BMP Unicode. A string se rompe e o parser recusa o documento inteiro. O erro pode aparecer longe da origem quando o JSON está aninhado em vários níveis ou serializado dentro de outro sistema.

A abordagem correta é sempre usar a função de serialização da linguagem: JSON.stringify para JavaScript e TypeScript, json_encode para PHP, json.dumps para Python e JsonSerializer.Serialize para .NET. Esta ferramenta aplica exatamente essa lógica: converte qualquer texto em um literal de string JSON pronto para incorporar em arquivos ou payloads, sem risco de quebrar a sintaxe.

O sentido inverso, o unescape, é útil ao receber um literal JSON serializado dentro de outro JSON, o chamado double-encoded JSON. Esse padrão aparece com frequência em logs de aplicação e mensagens de fila, quando a camada de log serializa o objeto inteiro como string em vez de aninhá-lo diretamente no documento.