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.
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.
6 minutos de lectura
Esquema JSON a JSON: de la carga útil de muestra al contrato
Convierta el esquema JSON en JSON en el navegador: infiera un borrador a partir de una carga útil real, luego refuerce los campos, formatos y enumeraciones requeridos, además de los límites de inferencia.
6 minutos de lectura
YAML a JSON: convertir configuraciones sin perder la cabeza
Convierta YAML a JSON en el navegador con soporte para múltiples documentos y ubicaciones exactas de los errores, además de los errores YAML que silenciosamente interrumpen los procesos de CI.
- Artículo más largo para leer: YAML vs JSON: cuándo usar cuál (y cómo convertir)