Por qué el formateador no responde

¿Qué hacer si el formateador JSON no responde? Causas y soluciones de los errores de JSON no válido

Cuando pegas JSON en un formateador y no responde o aparece un error en rojo, en la gran mayoría de los casos no es que la herramienta esté rota, sino que el JSON que introdujiste tiene errores de sintaxis. El flujo de trabajo del formateador es primero analizar y luego embellecer; el paso de análisis es extremadamente estricto: basta con que un solo carácter no cumpla la norma para que todo el documento no pase la validación, y la herramienta no producirá ninguna salida. Por lo tanto, cuando no responde, tu primera reacción debería ser revisar la sintaxis del JSON, no cambiar de herramienta.

Por qué el formateador no responde

El formateador y el validador comparten el mismo mecanismo central: leer el texto, analizarlo según la especificación JSON y, tras confirmar que es válido, aplicar el formato. Si el análisis falla, la herramienta no tiene contenido que mostrar, lo que se manifiesta como falta de respuesta o un error directo.

Las reglas de sintaxis de JSON son mucho más estrictas que las de los literales de objeto de JavaScript. Las costumbres que tienes al escribir JS, como las comas finales, las comillas simples o las claves sin comillas, son todas ilegales en JSON. El texto copiado de herramientas de chat, PDF o procesadores de texto también puede contener caracteres especiales invisibles que igualmente provocan fallos de análisis.

Los errores de sintaxis JSON más comunes

Reconociendo los siguientes tipos de problemas podrás arreglar la mayoría de los datos dañados en un minuto.

Coma final

Añadir una coma después del último elemento de un objeto o array es legal en JavaScript pero ilegal en JSON. Esta es la causa más común de que el formateador no responda.

{"name": "Ada", "role": "engineer",} falla; {"name": "Ada", "role": "engineer"} sí pasa.

Comillas simples en lugar de dobles

JSON exige que cada clave y cada valor de cadena estén entre comillas dobles. Las comillas simples no son válidas, aunque muchos lenguajes de programación las acepten.

Claves sin comillas

Las claves deben ser cadenas. {name: "Ada"} no es válido; {"name": "Ada"} sí es correcto.

Comentarios

JSON no admite comentarios // ni / /. Si copiaste un archivo de configuración con comentarios, elimínalos antes de formatear.

Caracteres invisibles y comillas tipográficas

El texto pegado desde procesadores de texto, herramientas de chat o PDF puede contener comillas tipográficas, espacios de no separación o marcas de orden de bytes. Estos caracteres se ven idénticos a los normales en pantalla, pero hacen que el analizador falle directamente.

• Comillas tipográficas: " y ", en lugar de "
• Espacio de no separación, en lugar de espacio normal
• Una marca de orden de bytes al inicio del archivo

Si la línea que señala el error parece completamente normal, sospecha de caracteres invisibles. Vuelve a escribir esa línea manualmente y prueba de nuevo.

Método paso a paso para reparar JSON no válido

Sigue estos pasos en orden. La mayoría de los datos se arreglan en el tercer paso.

1. Pega el texto completo en el formateador. No recortes primero. La posición del error es relativa a todo el documento; recortar el texto desplazará el número de línea de cada línea.
2. Lee con atención el mensaje de error. Anota el número de línea y la posición del carácter. Si la herramienta no indica la posición, cambia a una que sí lo haga.
3. Revisa la línea del error en busca de los sospechosos habituales. Comprueba si hay comas finales, comillas simples o claves sin comillas.
4. Si esa línea parece correcta, revisa la línea anterior. La falta de una coma al final de la línea anterior suele reportarse en la línea siguiente.
5. Vuelve a escribir manualmente la línea marcada. Esto elimina los caracteres invisibles introducidos al copiar y pegar.
6. Vuelve a ejecutar el formateo. Si aún falla, repite los pasos 2 a 5. Cada corrección hará que la posición del error se desplace hacia adelante hasta que el documento sea completamente válido.

Si después de estos pasos sigue fallando, el problema puede no estar en la sintaxis sino en el tamaño del archivo. Las herramientas de navegador suelen empezar a ralentizarse alrededor de unos pocos megabytes, porque todo el documento debe caber en memoria de una vez. Para archivos muy grandes se recomienda usar herramientas de línea de comandos o software de escritorio.

Cuál es la diferencia entre un formateador y un validador

El formateador reescribe el JSON válido en una versión con sangría y saltos de línea para que sea fácil de leer. El validador solo comprueba si el JSON es sintácticamente correcto e informa de los errores. Muchas herramientas hacen ambas cosas a la vez: primero validan y, si pasa, formatean.

Este orden es importante. Cuando necesitas una respuesta de sí o no, por ejemplo en un paso de compilación o en una revisión de código, usa el validador. Cuando necesitas que una persona entienda los datos, usa el formateador.

En la práctica, esta diferencia rara vez cambia tu flujo de trabajo. Si el JSON no es válido, ninguna de las dos herramientas produce resultados y tendrás que corregir la sintaxis de todos modos. La pregunta realmente útil es: ¿te dice la herramienta dónde está el problema, o solo si hay un problema? Un buen mensaje de error incluye el número de línea y la posición del carácter.

Formatear JSON en el navegador

Pega el JSON en el panel de entrada; la herramienta lo analizará y devolverá la salida con sangría en la misma pestaña. Los datos no se suben a ningún servidor, todo permanece en tu propia máquina. Después puedes copiar el resultado o descargarlo como archivo.

Si quieres formatear JSON en el navegador sin instalar nada, la respuesta es: cualquier navegador moderno puede hacerlo. El análisis se realiza en tu propio dispositivo mediante JavaScript. Esto convierte las herramientas de navegador en una opción razonable para manejar configuraciones internas y datos de ejemplo.

Formatear JSON para depurar APIs

Leer directamente una respuesta de API sin formato es muy doloroso. La mayoría de los servidores devuelven JSON comprimido, en una sola línea sin ningún espacio. El formateo convierte esa línea en una estructura que puedes recorrer con la vista.

Cuando formateas JSON para depurar una API, fíjate en tres cosas:

1. Profundidad de anidamiento. Los objetos demasiado anidados suelen indicar que la estructura de la respuesta no es la que esperabas.
2. Valores nulos. Un campo que debería contener datos pero devuelve null suele apuntar a un problema del servidor.
3. Tipos que no coinciden. Un número devuelto como cadena, por ejemplo "42" en lugar de 42, rompe la lógica de comparación posterior.

La vista formateada hace visibles estas tres cosas de un vistazo. Úsala junto con el panel de red del navegador: copia el cuerpo de la respuesta, pégalo en el formateador y comprende la estructura antes de escribir cualquier código.

Un consejo práctico: formatea la respuesta antes de inspeccionarla en el depurador. Depurar paso a paso datos comprimidos es una pérdida de tiempo.

Consejos prácticos para formatear y validar

• Valida el JSON antes de enviarlo al repositorio de versiones, así el paso de compilación no fallará por una coma final.
• Formatea al leer o revisar configuraciones; la sangría hace evidente la jerarquía.
• Recuerda que formatear no cambia el significado de los datos. Solo cambia los espacios en blanco y los saltos de línea. Si después de formatear algún valor parece incorrecto, es un problema de los datos, no de la herramienta.
• Cuando solo necesites confirmar rápidamente si un fragmento de JSON es válido, basta con el validador; no hace falta generar la salida completa.

Preguntas frecuentes

¿Por qué mi formateador JSON no muestra nada?

Porque el análisis falló y la herramienta no tiene contenido que mostrar. Revisa comas finales, comillas simples, claves sin comillas y caracteres invisibles introducidos al pegar desde otro lugar.

¿Puede el formateador reparar JSON no válido?

No. El formateador solo da formato a entradas válidas. Los errores de sintaxis debes corregirlos tú o el validador primero.

¿Por qué la línea que señala el error parece completamente normal?

Probablemente el problema esté en la línea anterior, como una coma que falta, o en caracteres invisibles escondidos en esa línea. Volver a escribirla manualmente suele resolverlo.

¿Qué tamaño de archivo pueden manejar las herramientas de navegador?

No hay un límite uniforme, pero todo el documento debe cargarse en memoria de una vez, así que cuanto más grande sea el archivo, más fácil es que se ralentice. Para archivos muy grandes, es más seguro usar la línea de comandos o herramientas de escritorio.

¿El formateo cambia mis datos?

No. El formateo solo ajusta espacios en blanco y saltos de línea, no cambia ninguna clave ni valor. Pero tampoco te ayudará a detectar errores de tipo, como un número escrito como cadena; eso debes verificarlo tú mismo.