IA en tu dispositivo: profesional y privado.

Documentos

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ácterSe 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)\nSí, un salto de línea real dentro de una cadena no es válido
Retorno de carro\rSí
Tabulador\tSí
Retroceso, salto de página\b, \fSí
Otros controles U+0000 a U+001F\u0000 a \u001fSí, 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 DE00No, las dos formas son válidas
Apóstrofo 'tal cualNo, 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ónDirecciónQué obtienes
Una consulta SQL de varias líneas, un certificado o una plantilla tiene que convertirse en un único valor JSONEscapeUna 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 pruebaEscapeCada " escrita como \"
Una línea de log o un campo de una API se lee como una sola fila de \n y \"UnescapeEl texto legible, con saltos de línea reales
Un campo contiene un documento JSON completo como cadenaUnescapeEl documento interior, listo para el Formateador JSON
Quieres comprobar que el texto escapado dice lo que creesEscape y luego IntercambiarUn 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

1

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.

2

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.

3

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.

4

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.

5

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 JSON

Meter 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ónActívala cuandoCoste
Escapar no ASCII como \uXXXXEl 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 tiempoUn 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 sintaxisSeis 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

MensajeCausa habitualSolución
La cadena nunca se cierraEl valor quedó cortado por un límite de longitud del log o por una copia incompletaPega el valor completo o añade la comilla de cierre
Secuencia de escape desconocidaUna barra invertida delante de una letra que JSON no define, como \' o \U en una ruta de WindowsDuplica 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 escaparHay un salto de línea o un tabulador real dentro de la cadena, a menudo tras copiar desde una terminalUsa Escape sobre ese texto
Contenido extra tras la cadenaDos cadenas una al lado de otra, o texto tras la comilla de cierreConvierte un valor cada vez
Eso es un documento JSON, no una cadenaHas pegado un objeto o un arrayUsa 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.

Sigue leyendo

Más sobre Documentos →