03 / GUÍAS
Formatea e inspecciona JSON antes de revisarlo
La rutina de un revisor para payloads de API y archivos de configuración: formatea primero, inspecciona la estructura como árbol y compara dos documentos de forma determinista, sin enviar los datos a ninguna parte.
Por qué formatear va primero
El JSON minificado está hecho para máquinas: una línea, sin sangría, claves en el orden que produjo el serializador. Pedirle a tus ojos que revisen ese muro es como se cuelan un permiso eliminado, una bandera invertida o un endpoint inesperado.
Un formateador también es la comprobación de validez más barata que tienes. Un documento que no se puede analizar tampoco se iba a comportar en producción, y enterarte en una pestaña de revisión es mucho mejor que enterarte por el registro de despliegue.
- Solo legibilidadFormatear es una transformación de legibilidad: cambia espacios y saltos de línea, nunca los datos, así que una copia formateada siempre es segura de revisar contra el original.
- La profundidad es señalUna sangría consistente expone la profundidad de anidación de un vistazo, y la profundidad es donde se esconden los errores de configuración: una opción colocada un nivel demasiado hondo simplemente se ignora.
- Entrega la forma esperadaRevisa la copia formateada, pero entrega la forma que el sistema espera; la impresión legible es para humanos, no para la red.
Inspecciona el árbol, no solo el texto
Una vista de árbol responde a las preguntas que un revisor realmente hace —qué claves existen, de qué tipo es cada valor, qué profundidad tiene la estructura— sin escanear corchetes. El texto en bruto no responde rápido a ninguna.
JSON Tree Viewer analiza explícitamente: nada se renderiza hasta que pulsas Parse JSON, y la entrada no válida recibe un error localizado con una pista de reparación en lugar de un fallo silencioso. El resultado se abre como un árbol expandible con tipos y conteos por nodo, y la pestaña Formatted muestra el documento normalizado con la sangría que elijas.
El resumen de análisis informa el número de nodos y la profundidad máxima, una comprobación rápida de cordura contra lo que el payload debería contener. Las claves de prototipo reservadas se rechazan, así que un payload hostil no puede hacerse pasar por inocente mientras lo inspeccionas.
El árbol también aplana la conversación en una revisión: «el tercer elemento de items tiene price en null» es un comentario que cualquiera verifica en segundos, mientras que un desplazamiento de bytes en una línea minificada no lo es.
Abrir JSON Tree ViewerCompara dos documentos de forma determinista
Comparar dos documentos JSON a ojo falla en cuanto cambia el orden de las claves. Un diff estructural analiza ambos lados e informa lo que realmente cambió —valores añadidos, eliminados y modificados— sin importar el orden ni los espacios.
Text & JSON Diff ofrece tres modos: líneas, caracteres y JSON. El modo JSON es el determinista para revisiones: ambos documentos se analizan y luego se comparan valor a valor, así que las claves reordenadas y los espacios reformateados se reportan correctamente como idénticos.
Para texto que no es JSON, los modos de líneas y caracteres incluyen interruptores para ignorar espacios y normalizar saltos de línea, y el resumen cuenta adiciones, eliminaciones y cambios. Usa el modo JSON para payloads y configuración; vuelve al modo de líneas cuando un lado ni siquiera es JSON válido.
El determinismo importa más allá de la comodidad. Cuando dos revisores ejecutan la misma comparación deben obtener la misma respuesta; si no, la revisión se convierte en una negociación sobre herramientas en lugar de una decisión sobre el cambio.
Abrir Text & JSON DiffConoce los límites de los entornos locales
Son entornos locales con techos explícitos, dimensionados para payloads de revisión y no para procesamiento masivo de datos. Conocer el techo te dice cuándo recurrir a herramientas de escritorio.
Los techos existen porque el análisis y el diff se ejecutan en la misma pestaña en la que lees; un límite honesto es mejor que una página congelada, y el espacio reporta un límite excedido como un error explícito, no como un truncado silencioso.
- Techo del visorJSON Tree Viewer acepta hasta 256 KiB de entrada, cuarenta niveles de anidación y diez mil nodos: de sobra para una respuesta de API o un archivo de configuración.
- Techo del diffText & JSON Diff compara hasta 256 KiB por lado y reporta como máximo diez mil registros de diferencias antes de declarar la comparación demasiado compleja.
- Más allá del navegadorExportaciones mayores —volcados de bases de datos, archivos de registros, fixtures generados— pertenecen a un editor de escritorio o a una herramienta de línea de comandos, no a una pestaña del navegador.
Una lista de revisión de cinco minutos
Una rutina corta que atrapa la mayoría de los problemas de payloads antes de que lleguen a producción.
Ejecuta la lista también con los datos de muestra del productor y con el payload real; un fixture que discrepa con la realidad invalida la revisión tan seguramente como un error.
- AnalizaFormatea y analiza primero: confirma que el documento es válido y echa un vistazo al número de nodos y la profundidad frente a lo esperado.
- InspeccionaInspecciona el árbol: comprueba los tipos en las hojas; un identificador numérico que llega como cadena es un clásico error de integración.
- DiffCompara con la última versión buena conocida en modo JSON y lee cada cambio reportado antes de aprobar.
Mantén el payload en tu dispositivo
Los payloads de revisión suelen contener registros de clientes, tokens o URL internas. Un visor local mantiene ese material en la pestaña: el texto lo analiza código que se ejecuta en tu dispositivo y nunca se transmite como parte de la operación.
Esa frontera es lo que hace que estas herramientas sirvan con payloads reales de staging durante una revisión. No borra tus propias obligaciones: las exportaciones descargadas, el contenido del portapapeles y las capturas del árbol siguen siendo tu responsabilidad una vez que salen del espacio.
Si debes compartir un fragmento del payload en la revisión, pega el extracto mínimo que muestra el problema y redacta primero los identificadores: la misma disciplina que piden los canales de soporte.
Por qué la inspección local es una afirmación creíble.
Aprende cómo los entornos del navegador mantienen los datos en el dispositivo y cómo verificar la ruta de datos de cualquier herramienta con la que revises.