La primera vez que me importó minificar JSON no fue en un sitio web, sino en un microcontrolador. Estaba enviando un blob de configuración a un dispositivo con unos pocos kilobytes de memoria de sobra, y la versión bastante impresa que había estado editando a mano tenía casi el doble del tamaño de los mismos datos sin los espacios en blanco. Mismas claves, mismos valores, misma estructura: la única diferencia eran miles de espacios y nuevas líneas que existían puramente para que un humano pudiera leerlos. Elimínelos y ajuste la carga útil. Ese es el truco detrás de la minificación, y se aplica tanto a una respuesta API servida un millón de veces al día como a un archivo de configuración comprimido en un chip.
Esta guía es la versión completa de cómo y por qué minificar JSON, construida en torno a lo gratuito Minificador JSON herramienta. Explicaré qué elimina la minificación y qué deja en paz deliberadamente, por qué el JSON más pequeño es más rápido, en qué se diferencia la minificación del formato y del escape, y una propiedad sutil, la precisión numérica, que separa un minificador cuidadoso de uno descuidado. Es parte de la misma familia que el Formateador JSON Lo uso para el trabajo opuesto y pertenece al kit de herramientas que presenté en el Guía definitiva de las herramientas JSON.
TL;Dr: Minifying JSON elimina todos los espacios, pestañas y nuevas líneas que se encuentran entre los tokens, produciendo el texto más pequeño que analiza exactamente los mismos datos. Nada sobre las claves, los valores o su orden cambia; solo desaparecen los espacios en blanco. El Minificador JSON valida su entrada primero e informa el error exacto del analizador ' si tiene un formato incorrecto, elimina los espacios en blanco solo fuera de las cadenas literales para que el texto dentro de sus valores no se toque y conserva tokens numéricos byte por byte para que un valor como 1.0 permanezca 1.0. Un modo embellecer invierte el proceso con 2 espacios, 4 espacios o pestañas. Todo se ejecuta en su navegador.
¿qué hace realmente la minificación de JSON?
Un documento JSON es una secuencia de tokens: llaves, corchetes, dos puntos, comas, cadenas, números y literales true, falsey null. Entre esos tokens, la gramática JSON permite cualquier cantidad de espacios en blanco, y JSON bastante impreso usa esa asignación generosamente: una nueva línea después de cada coma, dos o cuatro espacios de sangría por nivel de anidamiento, un espacio después de cada colon. Todo ese espacio en blanco está ahí para los ojos humanos. Un analizador lo ignora por completo.
Minificar es el acto de eliminar cada uno de esos insignificantes caracteres de espacios en blanco, dejando solo los tokens en sí y la puntuación mínima que requiere la gramática. Una configuración que se lee como cuarenta líneas dentadas colapsa en una sola línea densa. Fundamentalmente, el datos es idéntico: analiza la versión minificada y la versión bonita y obtendrás exactamente el mismo objeto, con las mismas claves en el mismo orden y los mismos valores. La minificación cambia la representación, nunca el significado. La gramática en la que se basa todo esto se publica como RFC 8259, que es la autoridad sobre lo que se considera espacios en blanco insignificantes y lo que no.
El espacio en blanco de un solo lugar es no insignificante está dentro de una cuerda. Los espacios adentro "hello world" son parte del valor y deben sobrevivir intactos a la minificación. Por lo tanto, un minificador correcto no puede simplemente eliminar todos los espacios del texto; tiene que rastrear si está dentro de una cadena literal y dejar ese contenido en paz. El Minificador JSON hace exactamente esto, recorriendo el texto carácter por carácter y solo eliminando los espacios en blanco que se encuentran entre los tokens, para que nunca se pierda un espacio deliberado dentro de uno de sus valores.
¿por qué molestarse en minificar JSON?
La razón principal es el tamaño, y el tamaño se traduce directamente en velocidad y costo en la web. Cada byte de una respuesta JSON tiene que viajar a través de la red, y para una carga útil solicitada miles o millones de veces, los espacios en blanco suman ancho de banda real. La sangría y los saltos de línea suelen representar entre un quinto y un tercio del tamaño de un documento bastante impreso y #39;, por lo que la minificación puede reducir una porción significativa de cada transferencia. Las respuestas más pequeñas llegan más rápido, especialmente en conexiones móviles lentas, y su servicio cuesta menos cuando se paga por la salida. Es por eso que prácticamente todas las API de producción devuelven JSON minificado y todas las herramientas de compilación que agrupan datos en una aplicación web lo minifican primero.
También hay un beneficio de análisis, aunque es menor. Un analizador que no tiene que omitir ejecuciones de espacios en blanco tiene un poco menos de trabajo que hacer, lo cual importa en los márgenes de documentos muy grandes procesados en un bucle activo. Y hay un ángulo de almacenamiento que me trajo aquí en primer lugar: cuando estás colocando JSON en un espacio restringido (una cookie con un límite de tamaño, un dispositivo integrado, una columna de base de datos con tapa, un parámetro de consulta de URL), el formulario minificado es lo que lo hace encajar. La insignia de ahorro de tamaño en la herramienta le muestra el antes y el después en bytes y la reducción porcentual, para que pueda ver inmediatamente si vale la pena minificar un documento determinado o si ya estaba magro.
Qué hace la minificación no comprarte es secreto o compresión en el sentido pesado. Minified JSON sigue siendo texto sin formato y perfectamente legible para cualquier cosa que lo analice; eliminar espacios en blanco no es cifrado ni gzip. En el cable, JSON generalmente se comprime con gzip además de la minificación, y los dos son complementarios: la minificación elimina la redundancia que permite la gramática y gzip elimina la redundancia en el flujo de bytes. Minify por las razones anteriores, no porque creas que oculta algo.
¿en qué se diferencia la minificación del formato, el escape y la compresión?
Estas cuatro operaciones se confunden constantemente y mantenerlas claras le evita buscar la herramienta incorrecta. Actúan en diferentes cosas y resuelven diferentes problemas.
Minificando elimina espacios en blanco insignificantes para hacer un documento más pequeño y al mismo tiempo mantenerlo JSON válido. Formateo, o embellecer, hace lo contrario: agrega sangría y saltos de línea para que un documento sea legible, que es lo que desea cuando depura una respuesta API o edita una configuración a mano. El Minificador JSON hace ambas cosas, porque son dos direcciones del mismo eje: minificar para las máquinas, embellecer para las personas. Escapando es un eje completamente diferente: hace que un fragmento de texto sea seguro de colocar entromete una cadena JSON convirtiendo citas y caracteres de control en secuencias de barra invertida, que es el trabajo del Escape JSON / Unescape herramienta. Y compresión al igual que gzip opera en bytes sin procesar debajo de la capa JSON, reduciendo aún más la transferencia después de que la minificación haya hecho su parte.
La tabla establece las distinciones y puntos en la herramienta correcta para cada uno.
| Operación | Lo que cambia | ¿el resultado sigue siendo JSON? | herramienta |
|---|---|---|---|
| minificar | Elimina espacios en blanco entre tokens | Sí, los mismos datos | Minificador JSON |
| Embellecer/formatear | Agrega sangría y saltos de línea | Sí, los mismos datos | Formateador JSON |
| Escapar | Codifica el texto para que se encuentre dentro de una cadena JSON | Se convierte en un valor de cadena | Escape JSON / Unescape |
| Minify CSS | Elimina espacios en blanco de una hoja de estilo | Es CSS, no JSON | Minifiero CSS |
| Minify HTML | Elimina espacios en blanco del marcado | Es HTML, no JSON | Minifiero HTML |
La misma idea de minify para envío se ejecuta en todos los formatos, razón por la cual Minifiero CSS y Minifiero HTML siéntese justo al lado de este: una compilación completa minimiza los datos JSON, la hoja de estilo y el marcado por las mismas razones de ancho de banda.
¿minifying JSON alguna vez cambia mis datos?
La respuesta correcta es que minificar debería hacerlo nunca cambia tus datos y una buena herramienta lo garantiza. Pero hay una sutileza que separa a un minificador cuidadoso de uno ingenuo, y vale la pena entenderlo porque puede morderte.
Muchos minificadores funcionan analizando el JSON en un objeto en memoria y luego volviéndolo a serializar sin espacios en blanco. Ese viaje de ida y vuelta es conveniente, pero significa que cada valor pasa a través del lenguaje y el tipo de número #39;s en el camino, y eso puede reescribir cómo son los números escrito aunque el valor matemático no cambie. Un valor que escribiste como 1.0 vuelve como 1. Un valor como 1e3 vuelve como 1000. Un número entero con más dígitos que el tipo de número del idioma 's puede contener con precisión, cualquier cosa que supere los dieciséis dígitos significativos puede volver sutilmente alterado. Para la mayoría de los documentos, nada de esto importa, pero si su JSON contiene cadenas de versiones, identificadores de bases de datos o decimales de precisión fija como números, un minificador de análisis y restringificación puede corromperlos silenciosamente.
los Minificador JSON evita la trampa minificando de manera diferente. Todavía valida su entrada analizándola, por lo que se detecta e informa JSON con formato incorrecto. Pero para producir la salida, elimina los espacios en blanco directamente de su texto original en lugar de volver a serializar un objeto analizado, lo que significa que cada token numérico se conserva exactamente como lo escribió. Un cero final 1.0 se queda 1.0; un entero de treinta dígitos mantiene los treinta dígitos. Obtienes la reducción de tamaño de la minificación sin ningún riesgo de que tus números se reescriban: lo mejor de la validación y la fidelidad byte por byte. La dirección de embellecimiento, que se trata de legibilidad más que de transporte, normaliza el formato mediante una reserialización estándar, que es el comportamiento esperado cuando se reformatea para lectura humana.
¿cómo leo los errores cuando mi JSON no se minifica?
La herramienta se valida antes de minificar, lo que significa que un documento con formato incorrecto produce un error en lugar de una salida rota, y ese error es una característica, no un obstáculo. Le dice que el JSON tiene un problema real antes de que lo envías a algún lugar que lo rechazara de manera menos útil.
Los mensajes provienen directamente del analizador JavaScript JSON y normalmente nombran una posición. Las causas más comunes son una coma final después del último elemento de una matriz u objeto, que prohíbe JSON estricto; una clave que no está incluida en comillas dobles, ya que JSON requiere claves citadas a diferencia de los literales de objetos JavaScript; una cadena que utiliza comillas simples en lugar de dobles; y un corchete o tirante desequilibrado donde algo se abrió y no se cerró. Cada uno de estos es una pequeña solución una vez que sabes dónde buscar y la posición informada te apunta al vecindario. Si su fuente es en realidad JSONC - JSON con comentarios y comas finales, como se usa en algunos archivos de configuración - no se minimizará tal cual, porque son extensiones en lugar de JSON estándar; elimine primero los comentarios y las comas finales, o conviértalos a JSON estricto y lo validará.
Cuando la estructura es válida pero no se puede ver porque dos documentos se comportan de manera diferente, embellecen ambos y los comparan, o los revisan Diferencia de JSON herramienta para ver exactamente qué claves o valores difieren. Depurar JSON es mucho más fácil en su bonita forma, que es el caso cotidiano que hice en el Guía de formateador JSON. Y debido a que toda esta validación y minificación ocurre en su navegador sin nada cargado, puede pegar de manera segura cargas útiles que contienen claves API, tokens o registros de clientes: el argumento de privacidad que establecí en su totalidad en el guía de privacidad de datos para herramientas en línea.
Un ejemplo trabajado: desde la configuración legible hasta la carga útil enviada
Aquí está el viaje de ida y vuelta que muestra la herramienta ganándose su lugar. Digamos que ha estado editando una configuración de servicio a mano, por lo que está bastante impresa para facilitar la lectura: claves de objeto en sus propias líneas, sangría de dos espacios, una estructura en blanco que es fácil de escanear. Antes de entrar en una variable de entorno con un límite de longitud, lo desea lo más pequeño posible.
Pegue la configuración en el Minificador JSON, haga clic en Minificar y colapsará en una sola línea. La insignia de tamaño puede leer algo así como 512 bytes hasta 340, una reducción de un tercio, que es la diferencia entre ajustar la variable y el límite #39;s y no. Copie la línea minificada directamente en su archivo de entorno. Observe que un tiempo de espera que escribió como 1.5 está quieto 1.5 y un recuento de reintentos de 3 está quieto 3 - los números no se tocan, y si tuvieras un identificador numérico largo, también sobreviviría intacto, porque la herramienta eliminó los espacios en blanco en lugar de analizar los valores.
Semanas más tarde, un informe de error te muestra mirando esa misma masa minificada en un registro, y es ilegible como una línea densa. Péguelo nuevamente en la herramienta, haga clic en Embellecer, elija dos espacios y se expandirá a la forma sangrada que realmente pueda escanear. Corrija el valor, minifique nuevamente, envíe nuevamente. Ese flujo bidireccional (embellecer para leer y editar, minificar para almacenar y enviar) es el ritmo diario, y tener ambos en un solo lugar con una lectura de tamaño e informes de errores exactos es lo que lo hace rápido. Para el conjunto más amplio de utilidades de construcción y envío, esto se encuentra entre ellas Kit de herramientas para desarrolladores web completa el resto.
Preguntas frecuentes
¿cómo minifico JSON en línea? Pegue su JSON en el área de entrada y haga clic en Minificar. La herramienta elimina todos los espacios en blanco fuera de los valores de cadena y muestra el resultado comprimido junto con los ahorros de tamaño. Todo se ejecuta en su navegador, por lo que no se carga nada.
¿minificar JSON cambia los datos? No. Minifying solo elimina los espacios en blanco entre tokens, por lo que las claves, los valores y su orden permanecen idénticos. Un documento minificado analiza exactamente el mismo objeto o matriz que el original bastante impreso.
¿por qué minificar JSON? El JSON minificado es más pequeño, por lo que se transfiere más rápido a través de la red, utiliza menos ancho de banda y analiza un poco más rápidamente. Las respuestas API, los archivos de configuración y los datos incluidos en las aplicaciones web generalmente se minifican en producción por estas razones.
¿esta herramienta conserva el formato de números como 1.0 o números enteros grandes? Sí. Debido a que elimina los espacios en blanco en lugar de analizar valores, los tokens numéricos se mantienen exactamente como los escribió. Un valor como 1.0 permanece en 1.0 y un número entero muy grande conserva todos sus dígitos, que un minificador de análisis y restringificación reescribiría.
¿cuál es la diferencia entre minificar y embellecer JSON? Minifying elimina los espacios en blanco para que JSON sea lo más pequeño posible para las máquinas, mientras que embellecer agrega sangría y saltos de línea para que sea legible para las personas. Esta herramienta hace ambas cosas: minificar para envío, embellecer para edición y depuración.
¿puede minificar JSON con comentarios o comas finales? No. El JSON estándar no permite comentarios ni comas finales, por lo que la herramienta los informa como errores durante la validación. Primero elimine los comentarios y las comas finales, o convierta su JSONC a JSON estricto y luego minifíquelo.
¿es seguro minificar JSON sensible aquí? Sí. Todo el procesamiento se realiza en JavaScript dentro de su navegador, por lo que no se envía JSON a ningún servidor, no se registra nada y la herramienta funciona con su conexión deshabilitada. Puede minificar de forma segura cargas útiles que contengan claves API o datos personales.
¿por qué mi JSON muestra un error en lugar de minificar? La herramienta valida su entrada antes de minificar, por lo que un error significa que el JSON tiene un formato incorrecto, generalmente falta una coma adicional, una clave sin comillas, una cadena con comillas simples o un corchete desequilibrado. El mensaje incluye la posición del problema para que puedas solucionarlo.
Esta guía acompaña al gratis Minificador JSON herramienta en Toolz.dev: sin registro, sin cargas, funciona sin conexión.
