Escape de Cadenas JSON

¿Qué es el Escape de Cadenas JSON?

El escape de cadenas JSON es el proceso de convertir caracteres especiales dentro de una cadena en secuencias de escape que los analizadores JSON pueden leer sin romper la estructura. La especificación JSON (ECMA-404 / RFC 8259) exige que ciertos caracteres dentro de los valores de cadena vayan precedidos de una barra invertida. Sin un escapado correcto, una comilla doble literal o un salto de línea dentro de una cadena terminaría la cadena prematuramente y produciría un error de análisis.

Toda cadena JSON está delimitada por comillas dobles. Cuando la cadena contiene una comilla doble, una barra invertida o un carácter de control (U+0000 a U+001F), el carácter debe reemplazarse por su secuencia de escape. Por ejemplo, un salto de línea literal se convierte en \n, un tabulador en \t y una comilla doble en \". Cualquier punto de código Unicode también puede representarse como \uXXXX, donde XXXX es el valor hexadecimal de cuatro dígitos.

Desescapar (la operación inversa) convierte esas secuencias de barra invertida de vuelta a los caracteres originales. Úsalo cuando recibes un payload JSON donde los valores de cadena están doblemente escapados, o cuando necesitas extraer texto sin procesar de una entrada de log JSON para mostrarlo en una interfaz o terminal. Los pipelines de agregación de logs se encuentran con esto constantemente: cuando un mensaje codificado en JSON se almacena como valor de cadena dentro de otro documento JSON, cada barra invertida de la cadena interna llega duplicada.

¿Por Qué Usar una Herramienta de Escape JSON?

Añadir o eliminar barras invertidas a mano es tedioso y propenso a errores, especialmente con texto multilínea, rutas de archivo o fragmentos de código embebidos. Una herramienta dedicada detecta los casos límite que la edición manual pasa por alto.

Casos de Uso del Escape de Cadenas JSON

Referencia de Secuencias de Escape JSON

La especificación JSON define exactamente dos escapes obligatorios (comilla doble y barra invertida) y seis secuencias de escape cortas para caracteres de control habituales. El resto de caracteres de control (U+0000 a U+001F) deben usar la forma \uXXXX. Los caracteres por encima de U+FFFF (como los emoji) pueden representarse como un par sustituto UTF-16: \uD83D\uDE00.

Escape JSON vs. Codificación JSON

Los desarrolladores a veces confunden escapar una cadena con codificar un documento JSON completo.

Ejemplos de Código

Todos los lenguajes principales disponen de funciones integradas para esto. Ejemplos en JavaScript, Python, Go y jq:

// JSON.stringify escapes a value and wraps it in quotes
JSON.stringify('Line 1\nLine 2')       // → '"Line 1\\nLine 2"'

// To get just the inner escaped string (no surrounding quotes):
const escaped = JSON.stringify('She said "hello"').slice(1, -1)
// → 'She said \\"hello\\"'

// Parsing reverses the escaping
JSON.parse('"tabs\\tand\\nnewlines"')  // → 'tabs\tand\nnewlines'

// Handling Unicode: emoji in JSON
JSON.stringify('Price: 5\u20ac')       // → '"Price: 5\u20ac"' (raw euro sign)

import json

# json.dumps escapes and quotes a string
json.dumps('Line 1\nLine 2')           # → '"Line 1\\nLine 2"'

# Ensure ASCII: replace non-ASCII with \uXXXX sequences
json.dumps('Caf\u00e9', ensure_ascii=True)   # → '"Caf\\u00e9"'

# Keep UTF-8 characters as-is (default in Python 3)
json.dumps('Caf\u00e9', ensure_ascii=False)  # → '"Caf\u00e9"'

# Unescape by round-tripping through json.loads
json.loads('"She said \\"hello\\""')      # → 'She said "hello"'

package main

import (
	"encoding/json"
	"fmt"
)

func main() {
	// json.Marshal escapes a Go string for JSON
	raw := "Line 1\nLine 2\tindented"
	b, _ := json.Marshal(raw)
	fmt.Println(string(b))
	// → "Line 1\nLine 2\tindented"

	// Unescape with json.Unmarshal
	var out string
	json.Unmarshal([]byte(`"She said \"hello\""`), &out)
	fmt.Println(out)
	// → She said "hello"
}

# Escape a raw string into a JSON-safe value
echo 'Line 1
Line 2	with tab' | jq -Rs '.'
# → "Line 1\nLine 2\twith tab\n"

# Unescape a JSON string back to raw text
echo '"She said \"hello\""' | jq -r '.'
# → She said "hello"

Preguntas Frecuentes