YamlBox

JSON herramientas · 6 minutos de lectura

Formateador JSON: bonito, minimizado y realmente válido

Un formateador JSON realiza tres trabajos, y vale la pena saber cuál necesita realmente: hace legible el JSON denso, hace legible el JSON compacto y le indica exactamente dónde un archivo dejó de ser válido JSON. La mayoría de las personas recurren a un formateador porque algo está roto, y el mensaje de error, no la bonita impresión, es la parte que salva la tarde.

Actualizado

Pretty-print: para humanos y solicitudes de extracción

Sangrado JSON es revisable JSON. Dos espacios es la convención en la mayoría de las bases de código JavaScript y coincide con el valor predeterminado en `JSON.stringify(value, null, 2)`; cuatro editores de trajes espaciales configurados de esa manera. La elección del formato importa menos que la coherencia, porque la sangría mixta convierte cada diferencia posterior en ruido. Si se genera su JSON, configure la sangría en el generador una vez y deje que el formateador la aplique localmente para las cargas útiles pegadas.

Minimizar: para cargas útiles en el cable

Los espacios en blanco en JSON son opcionales, por lo que eliminarlos es un ahorro gratuito. En una respuesta API de 200 KB, la diferencia suele ser del 15 al 30 por ciento de los bytes, lo que importa cuando el presupuesto es una conexión móvil o un encabezado de caché que intenta respetar. Minimizar también es el movimiento correcto antes de almacenar una carga útil en una columna de base de datos o incrustarla en un URL; simplemente minimice como un paso de compilación en lugar de manualmente, ya que JSON minimizado manualmente es donde la depuración muere.

Validación: los errores que realmente cometerás

JSON es una gramática deliberadamente pequeña, razón por la cual sus errores son tan repetitivos. Casi todos los errores JSON no válidos se remontan a uno de los cinco hábitos adquiridos en JavaScript o YAML:

  • Comas finales: `{"a": 1,}` es JavaScript válido y JSON no válido.
  • Comillas simples o claves sin comillas: `{a: 'b'}` debe convertirse en `{"a": "b"}`.
  • Comentarios: `// note` y `/* note */` no tienen ningún lugar en JSON.
  • Caracteres de control sin escape: las nuevas líneas literales dentro de una cadena deben ser `\n`.
  • Objetos concatenados: dos objetos de nivel superior uno al lado del otro, generalmente de un archivo de registro con un documento JSON por línea.

Un formateador debe indicarle la línea, la columna y mostrar el extracto. El “token inesperado” por sí solo te deja desplazándote; “línea 84, columna 17: coma al final antes de }” es una solución.

¿Por qué validar antes de depurar?

Cuando falla una integración, el instinto es inspeccionar el código. Más a menudo, la carga útil en sí tiene un formato incorrecto: una plantilla emitió una coma perdida, una canalización de registro truncó una línea o copiar y pegar de un documento introdujo comillas tipográficas. Al ejecutar el formateador JSON primero se separa “los datos son incorrectos” de “el código es incorrecto” en segundos, y el número de línea exacto generalmente apunta directamente a la plantilla que los produjo.

Archivos grandes y privacidad

Las respuestas API y las exportaciones de bases de datos frecuentemente contienen tokens, campos personales o datos de clientes. Un formateador JSON del lado del servidor significa cargar esa carga útil a un tercero para que se la devuelva, una cuestión de protección de datos sin ventajas, ya que el formateo es una operación local trivial. El formateador YamlBox JSON analiza en el navegador sin llamadas de red, por lo que funciona sin conexión y mantiene su carga útil en su máquina; la misma página le ofrece opciones de sangría, clasificación de claves para diferencias estables y estadísticas en vivo, como profundidad y recuento de claves.

JSON Formateador — preguntas frecuentes

¿Cuál es la diferencia entre formatear y validar JSON?

El formateo solo cambia los espacios en blanco y siempre es seguro una vez que se analiza el documento. La validación es la verificación de que analiza en absoluto: un formateador que no puede analizar su entrada informará una línea y columna en lugar de producir una salida, y ese informe es la parte útil.

¿Cuánto más pequeño es JSON?

Normalmente, entre un 15 y un 30 por ciento, dependiendo de qué tan profundamente anidado esté el documento y de la longitud de las claves. La minimización no produce pérdidas: los espacios en blanco entre tokens no tienen significado en JSON, por lo que un documento minimizado se analiza exactamente con el mismo valor.

¿Es seguro formatear JSON que contiene secretos en el navegador?

Sí, cuando el formateador se ejecuta completamente en el lado del cliente. No hay carga ni solicitud a un servidor, por lo que los tokens en la carga útil permanecen en su pestaña y la página sigue funcionando cuando la red está apagada, lo cual puede verificar usted mismo.

Herramientas mencionadas en esta publicación.

Explore la lista completa de 19 herramientas

Más artículos para leer

6 minutos de lectura

JSON diff: comparar datos tal como están realmente

Compare dos cargas útiles JSON con una diferencia estructural JSON que ignora el orden de las claves y los espacios en blanco, resalta los valores movidos y muestra por qué las diferencias de texto son engañosas.

Todas las 19 publicaciones →