JSON escape / 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.

When you embed text into a JSON value, certain characters must be escaped to avoid breaking the document structure. ECMA-404 defines which ones: double quotes must be preceded by a backslash, backslashes themselves are doubled, and control characters such as newline, carriage return, and tab get specific two-character sequences. Unicode characters outside the basic ASCII control range can be represented using four-digit hexadecimal notation.

The most common bug appears when building JSON manually by string concatenation. Everything works fine until a user types a double quote, a backslash, or an emoji outside the Unicode BMP. The string breaks and the parser rejects the entire document. The error may surface far from the origin when the JSON is nested across multiple layers or serialized inside another system.

The right approach is always to use the language serialization function: JSON.stringify for JavaScript and TypeScript, json_encode for PHP, json.dumps for Python, and JsonSerializer.Serialize for .NET. This tool applies exactly that logic: converts any text into a JSON string literal ready to embed in files or payloads, with no risk of breaking syntax.

The reverse direction, unescape, is useful when you receive a JSON literal serialized inside another JSON, the so-called double-encoded JSON. This pattern appears frequently in application logs and queue messages, when the logging layer serializes the entire object as a string rather than nesting it directly in the document.

Cuando incrustas texto en un valor JSON, ciertos caracteres deben escaparse para no romper la estructura del documento. ECMA-404 define cuáles: las comillas dobles deben ir precedidas de barra invertida, la propia barra invertida se duplica, y los caracteres de control como nueva línea, retorno de carro y tabulación obtienen secuencias específicas de dos caracteres. Los caracteres Unicode fuera del ASCII básico de control pueden representarse con la notación de cuatro dígitos hexadecimales.

El bug más habitual aparece al construir JSON manualmente por concatenación de cadenas. Todo funciona bien hasta que un usuario escribe una comilla doble, una barra invertida o un emoji fuera del BMP de Unicode. La cadena se rompe y el parser rechaza el documento entero. El error puede surgir lejos del origen cuando el JSON está anidado en varios niveles o serializado dentro de otro sistema.

El enfoque correcto es siempre usar la función de serialización del lenguaje: JSON.stringify en JavaScript y TypeScript, json_encode en PHP, json.dumps en Python y JsonSerializer.Serialize en .NET. Esta herramienta aplica exactamente esa lógica: convierte cualquier texto en un literal de cadena JSON listo para incrustar en archivos o payloads, sin riesgo de romper la sintaxis.

El sentido inverso, el unescape, es útil al recibir un literal JSON serializado dentro de otro JSON, el llamado JSON doblemente codificado. Este patrón aparece con frecuencia en logs de aplicación y mensajes de cola, cuando la capa de log serializa el objeto entero como cadena en lugar de anidarlo directamente en el documento.