CodeKitHub
Español
Cómo ver un archivo JSON muy grande sin que se cuelgue el navegador

Cómo ver un archivo JSON muy grande sin que se cuelgue el navegador

Publicado el 23 jul 2026

Si pegas un volcado de API de 50 MB o una exportación completa de una base de datos en cualquier herramienta JSON basada en navegador —incluida esta—, la pestaña se ralentizará o se bloqueará por completo. No se trata de un error de una herramienta concreta, sino de una característica propia de cómo los navegadores representan el texto y el DOM. Esto es lo que ocurre realmente y cómo solucionarlo.

Por qué los archivos JSON grandes bloquean el navegador, y no solo «se cargan lentamente»

Se acumulan dos costes distintos:

  1. Coste de análisis sintáctico. JSON.parse en una cadena bien formada de 50 MB tarda entre medio segundo y un par de segundos en un portátil normal; es perceptible, pero no es el verdadero problema.
  2. Coste de representación. Este es el que realmente bloquea la pestaña. Si una herramienta representa el resultado formateado como un bloque gigante de texto (o peor aún, un árbol plegable con un nodo DOM por clave), el navegador tiene que maquetar y dibujar potencialmente millones de nodos DOM. Esto es lo que hace que la pestaña deje de responder, no el análisis sintáctico.

Así pues, el límite de tamaño con el que te topas casi nunca proviene de la especificación JSON ni del analizador sintáctico, sino de pedirle al navegador que dibuje una enorme cantidad de texto o una interfaz de usuario anidada de una sola vez.

El flujo de trabajo real para archivos realmente grandes

No abras el archivo completo en ningún lugar del navegador. En su lugar:

  1. Extrae primero solo la parte que necesites. Si estás depurando un registro erróneo dentro de un volcado de 200 MB, no necesitas tener delante los otros 199 MB. Las herramientas de línea de comandos se encargan de esto sin cargar nunca el archivo completo en memoria, como hace una pestaña del navegador:
# pull out one top-level key from a huge file, streaming
jq '.results[42]' huge-file.json > fragment.json

# or just grep for context around a known string first
grep -n '"user_id": 88214' huge-file.json
  1. Formatea solo ese fragmento en el navegador. Unos pocos KB de JSON extraído se formatean al instante y son realmente legibles; este es el mismo hábito de «formatear solo el fragmento que te interesa» que vale la pena adquirir para cualquier registro o volcado de gran tamaño, no solo para este error concreto.
  2. Si tienes que inspeccionar la estructura, no los valores, ejecuta primero jq 'keys' o jq '. | length' localmente para comprender la forma antes de decidir qué extraer. No necesitas ver 50 000 entradas de un array para saber que el array tiene 50 000 entradas.

Cuándo una herramienta del navegador es realmente adecuada

En la gran mayoría de los casos de depuración reales —una respuesta de API, un archivo de configuración, la carga útil de un webhook—, se trata de kilobytes o unos pocos megabytes, no de cientos. En ese rango, pegar directamente en un formateador y obtener un resultado instantáneo y legible con las ubicaciones exactas de los errores es más rápido que recurrir a la línea de comandos. El tamaño a partir del cual esto deja de funcionar es mucho mayor de lo que la mayoría de la gente supone; son concretamente «decenas de megabytes y más» lo que causa verdaderos problemas, no «más de una página».

Referencia rápida

Tamaño del archivo Qué hacer
Menos de ~5 MB Pegar directamente en un formateador del navegador: instantáneo y sin problemas
~5–30 MB Sigue siendo viable, pero hay que contar con una breve pausa; formatear solo lo que necesites leer
Más de 30 MB Extrae primero el fragmento relevante con jq / grep y formatea solo eso

La herramienta no necesita un «modo de archivos grandes» para solucionar esto: la solución consiste en extraer el contenido antes de visualizarlo, lo cual es un cambio en el flujo de trabajo, no una limitación de la herramienta.

← Volver al blog