Escape y unescape de JSON: qué caracteres hay que escapar y cómo arreglar cadenas escapadas dos veces
JSON escape y unescape explicados: qué caracteres hay que escapar en JSON, cómo meter un JSON dentro de una cadena y cómo arreglar comillas escapadas dos veces.
Actualizado el 8 de noviembre de 202610 min de lectura
Para hacer el escape JSON de un texto se pone una barra invertida delante de cada comilla doble y de cada barra invertida, se sustituyen los saltos de línea y los tabuladores por \n, \r y \t, y el resultado se rodea de comillas dobles. El unescape hace lo contrario: \" vuelve a ser una comilla y \n vuelve a ser un salto de línea real. Esas son casi todas las reglas, y la herramienta Escape Unescape de Cadenas JSON las aplica con exactitud, en las dos direcciones. Casi todos los problemas vienen de lo que pasa alrededor de esas reglas: un JSON pegado dentro de otra cadena JSON, barras invertidas que se multiplican cada vez que se guarda un valor y caracteres que son válidos en JSON pero rompen el lugar donde los pegas. Esta guía trata cada uno de esos casos.
Qué significa escapar en JSON y qué caracteres lo necesitan
Una cadena JSON empieza y termina con una comilla doble. Todo lo que haya dentro y pueda confundirse con el final de la cadena o con el inicio de un escape tiene que escribirse de otra forma. El estándar JSON (RFC 8259) obliga a escapar exactamente tres grupos de caracteres: la comilla doble, la barra invertida y todos los caracteres de control de U+0000 a U+001F, entre ellos el salto de línea y el tabulador. Todo lo demás, incluidas las letras con tilde, los emojis, los apóstrofos y la barra normal, puede aparecer tal cual.
| Carácter | Se escribe en JSON como | ¿Obligatorio? |
|---|---|---|
| Comilla doble " | \" | Sí, si no, termina la cadena |
| Barra invertida \ | \\ | Sí, si no, inicia un escape |
| Salto de línea (line feed) | \n | Sí, un salto de línea real dentro de una cadena no es válido |
| Retorno de carro | \r | Sí |
| Tabulador | \t | Sí |
| Retroceso, salto de página | \b, \f | Sí |
| Otros controles U+0000 a U+001F | \u0000 a \u001f | Sí, no tienen forma corta |
| Barra normal / | / o \/ | No, las dos formas son válidas |
| No ASCII, como é o 😀 | tal cual, o \u00e9 y el par D83D DE00 | No, las dos formas son válidas |
| Apóstrofo ' | tal cual | No, y \' no es un escape válido |
La última fila sorprende a mucha gente. JavaScript y Python aceptan \' dentro de una cadena, así que parece natural, pero JSON no lo define. Un analizador que encuentra \' se detiene con un error. En JSON el apóstrofo no necesita ningún escape, y las comillas simples nunca pueden usarse para delimitar una cadena.
Escape o unescape: cuál necesitas
| Tu situación | Dirección | Qué obtienes |
|---|---|---|
| Una consulta SQL de varias líneas, un certificado o una plantilla tiene que convertirse en un único valor JSON | Escape | Una sola línea con \n donde estaban los saltos |
| Una cadena llena de comillas tiene que ir a un archivo de configuración o a un fixture de prueba | Escape | Cada " escrita como \" |
| Una línea de log o un campo de una API se lee como una sola fila de \n y \" | Unescape | El texto legible, con saltos de línea reales |
| Un campo contiene un documento JSON completo como cadena | Unescape | El documento interior, listo para el Formateador JSON |
| Quieres comprobar que el texto escapado dice lo que crees | Escape y luego Intercambiar | Un viaje de ida y vuelta que debe devolver el original exacto |
Escapar no es cifrar ni comprimir. Solo cambia cómo se escriben los caracteres especiales para que un analizador los lea como texto. Si lo que necesitas es convertir datos binarios, como una imagen, en texto, es otro trabajo, explicado en qué es la codificación Base64. Si el texto va a una dirección web, necesita codificación por porcentaje con el codificador de URL.
Cómo escapar o desescapar una cadena JSON, paso a paso
Elige la dirección
Abre la herramienta de escape JSON y elige Escape para convertir texto plano en un literal de cadena JSON, o Unescape para convertir una cadena JSON de nuevo en texto.
Añade tu texto
Pega en el cuadro y pulsa Usar este texto, o suelta un archivo .json, .txt, .log, .ndjson u otro archivo de texto similar en la zona de carga. Se reconocen tanto UTF-8 como UTF-16.
Ajusta las opciones
En Escape, Rodear el resultado de comillas viene activado; desactívalo si vas a pegar el resultado entre comillas que ya existen en tu código. Las otras tres opciones se explican más abajo. En Unescape, deja Capas a pelar en Automático (hasta 10) salvo que quieras parar a mitad de camino.
Ejecútalo y revisa los recuentos
Pulsa Escape o Unescape. El resultado aparece junto al original con el número de caracteres y de bytes y una proporción de crecimiento, que importa cuando el valor tiene que caber en una columna o en un límite de tamaño de la petición.
Copia, descarga o intercambia
Copia el resultado, descárgalo como archivo de texto o pulsa Intercambiar para devolverlo a la entrada en la dirección contraria y confirmar que recuperas tu texto original.
Convierte texto en una cadena JSON o descodifica una de vuelta, con las capas anidadas peladas automáticamente. Gratis: un archivo o texto pegado de hasta 10 MB, con todas las opciones. Pro: sin límite de tamaño fijo y hasta 20 archivos a la vez, descargados en un único ZIP. Todo se ejecuta en tu dispositivo, no en nuestros servidores.
Escapar o desescapar JSONMeter un JSON dentro de una cadena JSON
A veces un documento JSON entero tiene que viajar como una sola cadena: el contenido de un webhook guardado en una columna de base de datos, un objeto de configuración que pasa por una cola que solo admite texto o el campo de mensaje de un evento de log. Para eso se escapa el documento. El objeto {"name":"Ana"} se convierte en la cadena "{\"name\":\"Ana\"}". Cada comilla interior gana una barra invertida y el conjunto gana un par de comillas exteriores.
Antes de escapar un documento, asegúrate de que es válido: escapar un objeto al que le falta una coma da una cadena perfectamente válida que contiene un documento roto. Pásalo antes por el Validador JSON. Si el tamaño importa, quita la sangría con el Minificador JSON antes de escapar: cada salto de línea de un documento formateado se convierte en un \n de dos caracteres y los espacios de sangría se conservan, así que un documento formateado y escapado es bastante más grande que uno minificado y escapado.
En sentido contrario, cuando una API devuelve un campo cuyo valor empieza por "{\", estás ante un documento incrustado. Desescápalo una vez y recuperas un JSON real, que luego puedes formatear y leer.
Doble escape: por qué se multiplican las barras invertidas
Cada vez que se escapa un valor, cada barra invertida existente se duplica y cada comilla gana una más. Un salto de línea que es \n tras una ronda pasa a \\n tras dos y a \\\\n tras tres. Si lo desescapas una vez, sigue pareciendo escapado, y por eso hay quien cree que la herramienta no ha funcionado. Sí ha funcionado: ha quitado una capa de varias.
Deja Capas a pelar en Automático y la herramienta sigue mientras el resultado siga siendo una cadena JSON entre comillas, hasta diez capas, y luego te dice cuántas ha quitado. Elige un número del 1 al 10 si quieres parar en una capa interior, por ejemplo para pasar un documento incrustado al formateador en lugar de seguir descodificándolo. Un texto normal que solo contiene \n por casualidad nunca se pela, porque una capa solo se quita cuando lo que queda se analiza de verdad como cadena JSON.
Las causas habituales del doble escape, para que puedas corregirlo en el origen:
- Serializar dos veces. Llamar a JSON.stringify en JavaScript o a json.dumps en Python sobre algo que ya es una cadena JSON la vuelve a envolver. Serializa el objeto una sola vez, en el último paso.
- Bibliotecas de logs. Los registradores estructurados escapan el mensaje, y algunas canalizaciones vuelven a escapar el evento completo al reenviarlo.
- Escapar a mano y luego con código. Añadir \" tú mismo y después pasar el texto por un serializador da \\\".
- Copiar desde un depurador o una consola. Algunas consolas muestran las cadenas en su forma escapada. Copiar esa vista y escaparla otra vez añade una capa.
- Rutas de Windows. C:\Users\Ana debe escribirse como C:\\Users\\Ana en JSON. Pegarla sin escapar da \U, que no es un escape válido, y escaparla dos veces da cuatro barras invertidas por separador.
Escapar según el destino de la cadena
Todo lo siguiente produce JSON válido en cualquier caso. Las tres opciones adicionales de la herramienta existen porque a veces al destino sí le importa.
| Opción | Actívala cuando | Coste |
|---|---|---|
| Escapar no ASCII como \uXXXX | El valor pasa por un sistema que no maneja UTF-8 de forma fiable, o quieres ASCII puro en el control de versiones | é pasa de 2 bytes a 6; un emoji, de 4 bytes a 12, como dos escapes |
| Escapar las barras como \/ | La cadena va dentro de un bloque script de HTML, donde </script> en una cadena cerraría la etiqueta antes de tiempo | Un byte más por barra |
| Escapar separadores de línea (U+2028, U+2029) | El literal se pega en código JavaScript para motores antiguos, donde estos dos caracteres invisibles eran un error de sintaxis | Seis bytes en lugar de tres por carácter |
Pegar en código es un caso aparte. Un literal de cadena JSON suele ser también una cadena válida en JavaScript, Python y Go, así que puedes pegar el resultado escapado entre tus propias comillas con la opción de comillas desactivada. En una shell, rodea el cuerpo JSON con comillas simples y las comillas dobles de dentro no necesitan más escape; en el símbolo del sistema de Windows no existen las cadenas entre comillas simples, así que cada comilla doble interior debe escribirse como \" para la línea de comandos, lo que es una segunda capa, independiente, encima de la de JSON.
Cuando el unescape falla: qué significa el error
| Mensaje | Causa habitual | Solución |
|---|---|---|
| La cadena nunca se cierra | El valor quedó cortado por un límite de longitud del log o por una copia incompleta | Pega el valor completo o añade la comilla de cierre |
| Secuencia de escape desconocida | Una barra invertida delante de una letra que JSON no define, como \' o \U en una ruta de Windows | Duplica la barra invertida o escapa el texto original |
| Escape \u incompleto | \u no va seguido exactamente de cuatro dígitos hexadecimales | \u12 no es válido; escribe \u0012 |
| Carácter de control sin escapar | Hay un salto de línea o un tabulador real dentro de la cadena, a menudo tras copiar desde una terminal | Usa Escape sobre ese texto |
| Contenido extra tras la cadena | Dos cadenas una al lado de otra, o texto tras la comilla de cierre | Convierte un valor cada vez |
| Eso es un documento JSON, no una cadena | Has pegado un objeto o un array | Usa el formateador o el validador; Unescape trabaja con una sola cadena |
Cada mensaje indica la línea y la columna y muestra el texto de alrededor, así que en una línea de log larga ves exactamente qué barra invertida causa el problema en lugar de tener que buscarla.
Preguntas frecuentes
¿Cómo escapo las comillas dobles en JSON?
Pon una barra invertida delante de cada una, de modo que " pasa a ser \". Antes hay que duplicar cualquier barra invertida que ya tenga el texto, o el resultado se leerá de otra forma. Al pegar el texto en el modo Escape se hacen las dos cosas y el resultado queda entre comillas.
¿Cómo desescapo una cadena JSON online?
Elige Unescape, pega la cadena con o sin sus comillas y ejecútalo. Deja las capas en Automático si el valor puede haberse escapado más de una vez; la herramienta indica cuántas capas ha quitado.
¿Por qué mi JSON tiene una barra invertida delante de cada comilla?
El valor se guardó como cadena en lugar de como objeto, normalmente porque se serializó dos veces. Desescápalo para recuperar el JSON interior y corrige el código que lo serializa para que lo haga una sola vez.
¿Puedo usar comillas simples o \' en JSON?
No. Las cadenas JSON deben usar comillas dobles, y \' no es un escape válido. Un apóstrofo dentro de una cadena entre comillas dobles está bien tal cual y no necesita barra invertida.
¿Hay que escapar las barras normales en JSON?
No. Tanto / como \/ son válidas y significan lo mismo. Escaparlas solo ayuda cuando el JSON va dentro de una etiqueta script de HTML, donde el texto </script> cerraría la etiqueta.
¿Qué tamaño de texto puedo escapar gratis?
La versión gratuita admite un archivo o un texto pegado de hasta 10 MB, con todas las opciones y todas las profundidades de unescape. Pro quita el límite fijo, trabaja hasta lo que tu dispositivo pueda manejar y acepta hasta 20 archivos a la vez.