Escapar cadenas de texto en JSON y JS: qué cambia y cómo

Contenido
Si pegas tal cual en una cadena JSON o JavaScript un texto que mezcla comillas, barras invertidas y saltos de línea, la cadena se corta a la mitad o aparece un error de sintaxis. Escapar consiste en sustituir, una por una, esos caracteres por una notación segura dentro de la cadena; desescapar es el camino inverso.
Este artículo muestra en una tabla en qué se convierte exactamente cada carácter especial del original y repasa los errores más habituales desde el punto de vista de "cómo leer el resultado".
Resumen ① Escapar recorre el original carácter a carácter y cambia la barra invertida por
\\, la comilla elegida por\", el salto de línea por\n, el tabulador por\ty el resto de caracteres de control por debajo de 0x20 por\uXXXX. ② Desescapar, que va en dirección contraria, devuelve a su carácter original notaciones como\n,\to\uXXXX; si quedan comillas en los extremos, hay que quitarlas con la opción de eliminación automática para que el resultado no se desajuste. ③ Los fallos más frecuentes son no procesar primero la barra invertida, lo que provoca un doble cambio, y que la comilla de entrada no coincida con la comilla elegida, lo que da un resultado distinto del esperado.
Al pegar, la cadena se corta en las comillas y los saltos de línea dan error
Imagina que tienes que meter un mensaje de log de varias líneas, o el texto de una respuesta de una API, como valor de un campo en un archivo de configuración JSON. Ese texto suele llevar comillas dobles y, al ocupar varias líneas, también saltos de línea reales.
Si lo pegas tal cual entre "...", las comillas dobles del contenido chocan con las que delimitan la cadena y esta se corta en ese punto. Además, las cadenas normales de JSON y JavaScript no admiten un salto de línea real dentro del valor, así que cada cambio de línea provoca un error de sintaxis.
Las rutas de Windows son otro caso habitual. Si metes C:\new\test tal cual en una cadena, \n y \t se interpretan como un salto de línea y un tabulador, y el valor que se muestra ya no coincide con el original. Escapar es convertir estos caracteres en una "notación segura dentro de la cadena".
Cómo escapar a mano, sin herramientas
El principio es sencillo: lees el original de izquierda a derecha, carácter a carácter, y solo sustituyes por la notación establecida los caracteres que pueden romper el literal de la cadena. El orden importa.
- Elige las comillas que envolverán la cadena. Qué caracteres hay que escapar depende de si el resultado irá en un literal con comillas dobles, con comillas simples o con acento grave (backtick). El valor por defecto son las comillas dobles.
- Sustituye primero la barra invertida. Cambia la barra invertida (
\) por\\. Debe ser lo primero para evitar un doble procesamiento: si no, al escapar después las comillas, volverías a tocar las barras invertidas que acabas de añadir. - Sustituye la comilla elegida. Pon una barra invertida delante de la comilla que hayas escogido. Si elegiste comillas dobles,
"pasa a ser\". Las comillas del otro tipo, las que no elegiste, no se tocan. - Convierte los caracteres de salto a su notación. El salto de línea pasa a
\n, el retorno de carro a\r, el tabulador a\t, el retroceso a\by el avance de página a\f. - Trata los caracteres de control restantes. Los caracteres de control por debajo de 0x20 que no tienen un nombre en la lista anterior (nulo, tabulador vertical, ESC, etc.) se convierten a la forma
\uXXXX:\useguido de cuatro dígitos hexadecimales.
Así se corresponde cada carácter original con su resultado:
| Carácter original | Resultado escapado |
|---|---|
Barra invertida \ | \\ |
Comilla elegida (por defecto ") | \" |
| Salto de línea (LF) | \n |
| Retorno de carro (CR) | \r |
| Tabulador | \t |
| Retroceso | \b |
| Avance de página | \f |
| Otros caracteres de control por debajo de 0x20 | \uXXXX |
Hay además dos opciones más. Si activas Envolver entre comillas, todo el resultado se envuelve una vez con la comilla elegida y obtienes un literal listo para pegar. Si activas Escapar también los no ASCII con \u, los caracteres fuera del rango ASCII, como los coreanos o los emojis, también se convierten a \uXXXX; los caracteres por encima de U+FFFF (la mayoría de los emojis) se dividen en un par sustituto, es decir, dos secuencias (\uXXXX\uXXXX).
Desescapar, que va en sentido contrario, recorre las reglas al revés. Cuando encuentra \, mira el carácter siguiente: \n \r \t \b \f \v \0 se convierten en el carácter de control correspondiente; \xXX \uXXXX \u{XXXXX}, en el carácter que corresponde a ese código; y las comillas, la barra invertida y la barra normal escapadas vuelven a su símbolo original. Si la cadena está envuelta en el mismo tipo de comillas por ambos extremos, se quita ese par.
Hay una diferencia entre ambas direcciones: al escapar, el tabulador vertical y el carácter nulo se escriben como ` ` y no como \v o \0, pero al desescapar también se reconocen las notaciones \v y \0 y se convierten en su carácter original.
Compruébalo con nuestra herramienta, Escapar cadenas de texto.
Convierte en el navegador en ambos sentidos: escapar y revertir. No requiere instalación ni registro, y el texto que escribes no se envía a ningún servidor.

Cómo leer el resultado: tres errores frecuentes
Las reglas son todas las que acabas de ver. Cuando el resultado no sale como esperabas, casi siempre es por alguno de estos tres puntos.
| Situación | Por qué se desajusta el resultado | Cómo corregirlo |
|---|---|---|
| La barra invertida se procesa tarde | La barra invertida de un \" ya insertado se vuelve a procesar y pasa a \\ (doble procesamiento) | Escapar la barra invertida en primer lugar |
| Comilla de entrada ≠ comilla elegida | Solo cambia la comilla elegida y las demás se quedan como estaban | Elegir la misma comilla que la del literal que envolverá el texto |
| Al desescapar, quedan comillas en los extremos | Las " del principio y del final se mezclan con el contenido y el resultado se desplaza un carácter | Activar la eliminación automática de comillas en los extremos |
El orden de la barra invertida. Si lo haces a mano y cambias primero las comillas, en el paso siguiente las barras invertidas que acabas de añadir se convierten de nuevo en \\. La herramienta recorre el original una sola vez, de izquierda a derecha, y no vuelve a leer las barras invertidas recién insertadas, por lo que este doble procesamiento no ocurre.
Tipo de comillas que no coincide. Si el texto va a ir en un literal con comillas simples pero lo escapas en modo de comillas dobles, las comillas simples del contenido se quedan tal cual. Al pegar el resultado dentro de '...', la cadena se corta en esas comillas simples. Lo primero que debes comprobar es que las comillas que envolverán el resultado y las que elegiste en la herramienta sean las mismas.
Comillas en los extremos al desescapar. Al revertir una cadena envuelta entre comillas, como "Hola\tHello", si no quitas esas comillas, quedará un carácter de comilla al principio y otro al final del resultado. Con la eliminación automática activada, si el primer y el último carácter son la misma comilla, se quita solo ese par.
Resumen
- Escapar lee el original carácter a carácter y convierte la barra invertida en
\\, la comilla elegida en\", el salto de línea en\n, el tabulador en\ty el resto de caracteres de control por debajo de 0x20 en\uXXXX. - A mano, hay que procesar la barra invertida en primer lugar para evitar el doble procesamiento. La herramienta recorre el texto una sola vez y evita este problema de forma automática.
- Lo que se escapa depende de las comillas elegidas. Elige el mismo tipo que las del literal donde vas a insertar el resultado para obtener lo esperado.
- Desescapar revierte
\n,\uXXXXy similares en sentido contrario, y las comillas de los extremos deben quitarse con la opción de eliminación automática para que el resultado no se desplace. - Si activas Escapar también los no ASCII con
\u, los caracteres coreanos y los emojis pasan a\uXXXX, y los caracteres por encima de U+FFFF se convierten en pares sustitutos.
Convierte en el navegador en ambos sentidos: escapar y revertir. No requiere instalación ni registro, y el texto que escribes no se envía a ningún servidor.
Preguntas frecuentes
¿Qué diferencia hay entre escapar y desescapar?
Van en direcciones opuestas. Escapar convierte el texto original, tal como lo lee una persona, en una notación que se puede incluir en un literal de cadena (\n, \", etc.), y desescapar devuelve esa notación a los caracteres originales. Con las pestañas de la parte superior de la herramienta cambias de una dirección a otra, y cada vez que modificas la entrada se recalculan al instante el resultado y el número de caracteres de la entrada y del resultado.
¿También puedo convertir texto en coreano o emojis a \u?
Si activas la opción "Escapar también los caracteres no ASCII con \u", los caracteres fuera del rango ASCII, como el hangul o los emojis, se convierten al formato \uXXXX. Los caracteres que superan U+FFFF, es decir, la mayoría de los emojis, se dividen en dos unidades de un par sustituto (surrogate pair). Si dejas la opción desactivada, esos caracteres se mantienen tal cual.
Voy a envolver el texto entre comillas simples, ¿por qué las comillas dobles se quedan igual?
Si el tipo de comillas seleccionado es comillas dobles, lo único que se escapa son las comillas dobles, así que las comillas simples del texto no se tocan. Si piensas poner el resultado dentro de '...', tienes que cambiar la selección a comillas simples para que estas se escapen como \'. Lo importante es elegir las mismas comillas que usará el literal que va a envolver el texto.
Al desescapar me quedan comillas al principio y al final.
Si la cadena que has introducido está rodeada de comillas en ambos extremos y la opción "Quitar automáticamente las comillas de los extremos" está desactivada, esas comillas se tratan como parte del contenido y se quedan delante y detrás del resultado. Al activar la opción, cuando el primer y el último carácter son la misma comilla (dobles, simples o acento grave), se quita solo ese par y luego se revierte el resto.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano