Formateador JSON
Formatea, valida y minifica JSON.
Conceptos básicos de sintaxis JSON
JSON (JavaScript Object Notation) sigue reglas de sintaxis estrictas:
- Los datos están en pares nombre/valor:
"name": "value" - Los objetos están envueltos en llaves:
{ } - Los arrays están envueltos en corchetes:
[ ] - Las cadenas deben usar comillas dobles, no simples
- No se permiten comas finales después del último elemento
- No se permiten comentarios en JSON
Tipos de datos JSON
JSON soporta seis tipos de datos. Entenderlos te ayuda a estructurar datos correctamente y evitar errores de validación.
Las cadenas son texto envuelto en comillas dobles. Los caracteres especiales como saltos de línea necesitan secuencias de escape como \n. Unicode está completamente soportado.
Los números pueden ser enteros o decimales, positivos o negativos. La notación científica también funciona. Pero sin ceros iniciales, sin NaN, sin Infinity.
Los booleanos son true o false en minúsculas. Sin comillas alrededor. Usar "true" lo convierte en cadena, no booleano.
Null representa un valor vacío o faltante. null en minúsculas, sin comillas. Diferente de una cadena vacía o cero.
Los arrays son listas ordenadas en corchetes. Pueden contener cualquier mezcla de tipos de datos, incluyendo otros arrays y objetos.
Los objetos son pares clave-valor en llaves. Las claves deben ser cadenas. Los valores pueden ser cualquier tipo. Los objetos pueden anidarse indefinidamente.
Errores comunes de JSON
Cuidado con estos errores frecuentes:
- Las comas finales como {"a": 1,} necesitan eliminar la coma final
- Las comillas simples como 'texto' deben ser comillas dobles
- Las claves sin comillas como {nombre: "valor"} deben estar entre comillas
- Los saltos de línea y tabulaciones dentro de cadenas deben escaparse
- Los ceros iniciales en números como 007 no son válidos
Cuándo minificar vs formatear
Minifica cuando necesites reducir el tamaño del archivo para respuestas API, almacenar JSON en bases de datos o localStorage, o transmitir datos eficientemente por redes.
Formatea (embellece) cuando necesites depurar o revisar estructura de datos, editar archivos de configuración, o documentar ejemplos de API.
Validación JSON
Este formateador valida tu JSON mientras lo procesa. Si ves un error, el mensaje te dice qué salió mal y aproximadamente dónde. Los problemas comunes incluyen comillas faltantes alrededor de claves, comas finales después del último elemento, y usar comillas simples en lugar de dobles. JSON es estricto por diseño, así que incluso pequeños errores de sintaxis harán que todo el documento falle al parsear.
Dónde se usa JSON
JSON se ha convertido en el formato estándar para intercambio de datos en la web. Lo encontrarás casi en todas partes.
Las APIs REST usan JSON para cuerpos de solicitud y respuesta. Cuando obtienes datos de cualquier API moderna, casi seguro estás recibiendo JSON.
Los archivos de configuración como package.json, tsconfig.json y .eslintrc usan JSON para almacenar configuraciones. Estos archivos controlan cómo se comportan las herramientas y aplicaciones.
Las bases de datos como MongoDB almacenan datos en documentos tipo JSON. localStorage y sessionStorage del navegador contienen cadenas JSON. Redis puede almacenar JSON con módulos.
Los microservicios se comunican usando JSON sobre HTTP. Los sistemas orientados a eventos pasan cargas JSON. Incluso los agregadores de logs a menudo esperan entradas de log formateadas en JSON.