Qué significa el escape JSON
El escape JSON transforma una cadena cruda (o un documento JSON serializado) para que pueda incrustarse de forma segura dentro de otro valor de cadena JSON. En JSON, ciertos caracteres deben escaparse con una barra invertida: comillas dobles (\""), barras invertidas (\\\\), y caracteres de control como saltos de línea (\n), retornos de carro (\r), tabulaciones (\t) y otros.
El caso de uso clásico es incrustar un documento JSON como valor de cadena dentro de otro documento JSON — un patrón común en payloads de API que transportan blobs de configuración crudos, cuerpos de webhook o respuestas serializadas.
El desescapado es lo contrario: tomar una cadena JSON escapada (con secuencias de barra invertida) y restaurarla a su forma original legible. Es útil cuando recibe una respuesta de API donde un campo contiene un payload JSON en formato cadena que quiere inspeccionar.
Secuencias de escape manejadas
La herramienta maneja todos los caracteres que la especificación JSON requiere escapar dentro de valores de cadena: comilla doble (→ \\"), barra invertida (→ \\\\\\\\), y los caracteres de control — retroceso (\\b), avance de página (\\f), salto de línea (\\n), retorno de carro (\\r), tabulación horizontal (\\t), y cualquier otro carácter de control con punto de código menor que U+0020.
Los caracteres Unicode más allá del Plano Multilingüe Básico (puntos de código superiores a U+FFFF) se representan como pares sustitutos en JSON. La herramienta maneja correctamente estos pares sustitutos tanto para emoji como para caracteres suplementarios.
La barra oblicua (/) es técnicamente opcional de escapar en JSON. Algunos serializadores la escapan (especialmente json_encode de PHP por defecto), mientras que otros no. Nuestra herramienta la escapa por defecto para máxima compatibilidad.
Casos de uso comunes
Incrustar JSON en HTML: Cuando genera una variable JSON en una página HTML, debe escapar el JSON para que los caracteres </script>, las comillas simples y los corchetes angulares no interfieran con el analizador HTML. Escapar JSON antes de incrustarlo en HTML es un paso relevante para la seguridad — el JSON no escapado en HTML puede llevar a vulnerabilidades XSS.
Variables de entorno: Almacenar un objeto de configuración JSON en una variable de entorno a menudo requiere que el JSON sea una cadena escapada de una sola línea, ya que la mayoría de los analizadores de variables de entorno no admiten valores multilínea.
Columnas de cadena de base de datos: Almacenar JSON en una columna TEXT o VARCHAR simple a veces requiere escape para evitar que las comillas dobles del JSON entren en conflicto con el delimitador de cadena SQL.