Cómo validar JSON rápidamente con Fluxom

Qué es JSON y por qué falla tanto

JSON (JavaScript Object Notation) es el formato de intercambio de datos más extendido en la web. Es ligero, legible y cualquier lenguaje moderno sabe leerlo. Pero su sintaxis es mucho más estricta que la de un objeto de JavaScript, y ahí está el origen de la mayoría de los errores.

Un documento JSON válido se construye con solo seis tipos de valor:

• Objetos entre llaves, con pares clave-valor.
• Arrays entre corchetes.
• Cadenas siempre con comillas dobles.
• Números en notación decimal.
• Booleanos: true y false, en minúsculas.
• Nulo: null.

Cualquier otra cosa, como comentarios, comillas simples o undefined, no existe en JSON. Un solo carácter fuera de sitio hace que el documento entero sea inválido.

Los errores más comunes

Después de ver miles de JSON rotos, los fallos se repiten. Estos son los siete más habituales:

1. Coma final. Es el clásico. {"a": 1,} es válido en JavaScript, pero no en JSON.
2. Comillas simples. {'a': 1} falla: JSON exige comillas dobles.
3. Claves sin comillas. {a: 1} funciona en un objeto literal, no en JSON.
4. Comentarios. Ni // ni /* */ están permitidos.
5. Valores no soportados. undefined, NaN e Infinity no existen en JSON.
6. Saltos de línea dentro de una cadena. Hay que escribirlos como \n.
7. Llaves o corchetes sin cerrar. Suele pasar al copiar solo una parte de la respuesta.

Este es un ejemplo con tres errores a la vez:

{
  'nombre': "Ana",   // usuario
  "edad": 30,
  "activo": true,
}

Tiene comillas simples, un comentario y una coma final. La versión correcta:

{
  "nombre": "Ana",
  "edad": 30,
  "activo": true
}

Cómo funciona el JSON Validator de Fluxom

El JSON Validator hace exactamente lo que haría tu código: intenta interpretar el texto con el analizador de JSON de tu navegador. Si lo consigue, el documento es válido y la herramienta te devuelve el contenido reformateado con sangría de dos espacios. Si no, te muestra el mensaje de error que ha producido el analizador.

El uso es directo:

1. Pega el JSON en el campo de entrada.
2. Pulsa Validar.
3. Si todo va bien, el campo se ilumina y el resultado aparece debajo, listo para copiar con el botón Copiar.
4. Si falla, el campo se marca en rojo y un aviso emergente indica el error.

Todo ocurre en tu navegador, sin enviar el contenido a ningún servidor. Puedes pegar una respuesta de una API interna con tranquilidad, siempre que no contenga credenciales reales.

Entender los mensajes de error

Los mensajes dependen del navegador y de su versión, pero siguen un patrón. Según el motor, verás frases como estas:

Unexpected token } in JSON at position 42
Unexpected token '}', "{"a":1,}" is not valid JSON
Unexpected end of JSON input
Expected property name or '}' in JSON at position 1

• «Unexpected token» indica un carácter que no debería estar en esa posición. Casi siempre es una coma final o una comilla simple.
• «Unexpected end of JSON input» significa que el texto se cortó: falta cerrar una llave o un corchete.
• «Expected property name» apunta a una clave sin comillas dobles.

Cuando aparece una posición, cuenta caracteres desde el inicio. En un documento largo resulta más cómodo localizarla si antes puedes pasar por el JSON Beautifier la parte que sí es válida, porque con sangría es fácil ver dónde se rompe la estructura.

Trucos de depuración que funcionan

Cuando el error no es obvio, estas estrategias suelen resolverlo:

• Biseca el documento. Valida la primera mitad y luego la segunda. Con tres o cuatro pasos localizas el trozo roto.
• Busca caracteres invisibles. Un espacio de no separación o una marca de orden de bytes al inicio pueden romper el análisis sin que se vea nada raro.
• Comprueba la doble codificación. Si ves barras invertidas por todas partes, como {\"a\":1}, el JSON fue convertido a cadena dos veces y hay que decodificarlo una vez antes de validarlo.
• Revisa las comillas tipográficas. Los editores de texto enriquecido cambian " por “ y ”, y esas comillas no son válidas.
• Copia desde la fuente. Si pegas desde un correo o un PDF, es posible que el texto haya sido modificado.

En tu propio código, el patrón seguro es envolver el análisis en un bloque try/catch y devolver un mensaje claro:

function leerJson(texto) {
  try {
    return { ok: true, datos: JSON.parse(texto) };
  } catch (error) {
    return { ok: false, motivo: error.message };
  }
}

Formatear, minificar y convertir

Validar suele ser el primer paso de un recorrido más largo. Una vez que el documento es correcto, puedes:

• Embellecerlo con el JSON Beautifier para revisarlo con comodidad.
• Minificarlo con el JSON Minifier para enviarlo o guardarlo con el menor tamaño.
• Convertirlo a tabla con JSON → CSV si es un array de objetos.

Un ejemplo del efecto de minificar:

{ "id": 7, "etiquetas": ["api", "rest"] }

se convierte en

{"id":7,"etiquetas":["api","rest"]}

Es el mismo dato con menos bytes, ideal para cabeceras, parámetros o almacenamiento.

Buenas prácticas para trabajar con JSON

Para cerrar, algunas costumbres que evitan problemas a largo plazo. Valida siempre los datos que vienen de fuera antes de usarlos. Mantén nombres de clave coherentes, por ejemplo siempre en minúsculas y con el mismo estilo. Usa cadenas para identificadores largos, porque un número muy grande puede perder precisión en JavaScript. Y no utilices JSON para archivos de configuración que necesiten comentarios: en ese caso, un formato como YAML se adapta mejor, y en Fluxom puedes pasar de uno a otro con los conversores de YAML.

Con estos hábitos y el JSON Validator a mano, los errores de sintaxis dejan de ser una causa de horas perdidas.