Reparar JSON

Relacionado

¿Qué es Reparar JSON (JSON Repair)?

Casos de uso

• Limpieza de salida IA/LLM: convierte con un clic JSON de ChatGPT/Claude envuelto en Markdown, con texto explicativo y comas finales a JSON estándar
• Depuración y resolución de problemas de interfaz: cuando las respuestas API se truncan por gateway o problemas de red, completa rápidamente corchetes y cadenas para localizar la estructura de datos original
• Literales de objeto JavaScript copiados de console: solución única para comillas simples, comas finales y claves sin comillas
• Limpieza de archivos de configuración: elimina comentarios de JSON5/JSONC para obtener JSON estándar, listo para consumo unificado aguas abajo
• Reparación de datos de log y portapapeles: estandariza rápidamente fragmentos JSON que contienen comentarios, espacios especiales o truncamiento
• Migración de datos y preprocesamiento de scripts: añade un paso de reparación en el pipeline de migración de datos para evitar que unos pocos JSONs inválidos bloqueen un lote ETL completo

Cómo Usar

1. Pega el contenido JSON con errores, envuelto en Markdown o truncado en la caja de entrada izquierda, o haz clic en "Ejemplo" para cargar un JSON roto típico, o sube un archivo .json/.txt
2. La herramienta detecta y repara automáticamente problemas de sintaxis comunes; el área de salida derecha muestra el JSON estándar formateado y el conteo de cada clase de problema reparado
3. Si quedan mensajes rojos de error, puedes editar manualmente la entrada y volver a disparar la reparación (Mac: ⌘+Shift+R, Windows: Ctrl+Shift+R)
4. Tras confirmar que la estructura es correcta, haz clic en "Copiar" para poner el resultado reparado en el portapapeles, o haz clic en "Descargar" para guardar como repaired.json para más formateo, validación, etc.

Características

• Cubre 7 errores de sintaxis comunes: comas finales, comillas simples, claves sin comillas, cadenas sin cerrar, comentarios, corchetes faltantes, envolturas de bloque de código Markdown
• Optimizado para limpieza de salida IA: elimina automáticamente envolturas ```json y texto explicativo circundante; reconoce salidas típicas de ChatGPT, Claude, Gemini y otros LLMs
• Compatible con JSON5/JSONC: parsea sintaxis extendida incluyendo comentarios, comillas flexibles y espacios especiales (ej. caracteres Unicode invisibles)
• Completado inteligente de JSON truncado: maneja respuestas API truncadas y llaves de cierre faltantes completando automáticamente los corchetes y comillas que faltan
• Visualización de problemas reparados: auto-estadísticas y muestra el conteo de cada clase de problema reparado para fácil auditoría y revisión humana
• Procesamiento local para privacidad: análisis, reparación y formateo ocurren localmente en el navegador, no se envía entrada a ningún servidor
• Conexión fluida con formateo: el JSON estándar reparado puede pasar directamente a Formatear JSON, Validación Schema, o generador de código como siguientes pasos
• Carga de archivos y ejemplos: soporta subir archivos .json/.txt o hacer clic para cargar un ejemplo para verificación rápida del efecto de reparación

Ejemplos de Código

// npm install jsonrepair
import { jsonrepair } from 'jsonrepair';

const broken = `{
  name: 'Alice',
  age: 30,
  tags: ['dev', 'writer',], // comma final + comentario
}`;

try {
  const fixed = jsonrepair(broken);
  const obj = JSON.parse(fixed);
  console.log(obj);
  // => { name: 'Alice', age: 30, tags: ['dev', 'writer'] }
} catch (err) {
  console.error('Aún no se puede reparar:', err.message);
}

# pip install jsonrepair
from jsonrepair import jsonrepair
import json

broken = '''{
  name: "Alice",
  age: 30,
  tags: ["dev", "writer",], // coma final + comentario
}'''

fixed = jsonrepair(broken)
obj = json.loads(fixed)
print(obj)
# => {'name': 'Alice', 'age': 30, 'tags': ['dev', 'writer']}

# Elimina comas finales de objetos/arrays (opción de emergencia; NO maneja comentarios / comillas simples)
# Para escenarios complejos, usa una librería dedicada como jsonrepair
sed -E 's/,([ \t]*[}\]])/\1/g' broken.json > clean.json

# Valida la salida limpiada
jq . clean.json >/dev/null && echo 'JSON es válido'

Preguntas Frecuentes

Solución de problemas

Glosario

JSON

JavaScript Object Notation, formato ligero de intercambio de datos basado en pares clave-valor definido en RFC 8259. Estándar de facto para API REST, archivos de configuración y logs.

RFC 8259

Especificación oficial JSON de IETF, define la sintaxis estricta del JSON válido — todas las claves deben ir entre comillas dobles, sólo un conjunto limitado de caracteres en cadenas necesitan escape, no se permiten comentarios ni comas finales.

JSON.parse

Parser JSON estricto integrado en JavaScript y navegadores modernos, conforme a RFC 8259. Lanza SyntaxError ante cualquier error de sintaxis y no puede realizar reparación tolerante.

JSON5

Sintaxis extendida para JSON (no estándar), permite claves sin comillas, cadenas con comillas simples, comentarios (// y /* */), comas finales, números hexadecimales, etc. Más fácil de escribir a mano pero incompatible con JSON.parse.

JSONC

JSON with Comments, nombre genérico usado por editores como VS Code para archivos de configuración JSON con comentarios (ej. tsconfig.json). Efectivamente un alias de JSON5.

Trailing Comma

Coma extra tras el último elemento de un objeto o array. Permitida en JavaScript pero prohibida por el estándar JSON — el error de sintaxis más común de salidas LLM y copias de console.log().

Bloque de Código Markdown

Fragmento de código envuelto en tres comillas invertidas (```). Los LLMs suelen envolver automáticamente la salida JSON en ```json ... ```; pegarlo directamente a JSON.parse() fallará.

Parser Tolerante

Parser que intenta recuperarse y continuar analizando al encontrar errores de sintaxis. El motor principal de una herramienta de Reparar JSON, distinto del JSON.parse estricto.

SyntaxError

Excepción de error de sintaxis lanzada por JavaScript. Cualquier parser JSON estricto la lanza al recibir entrada que no cumple RFC 8259.

JSON Canónico

JSON regenerado vía parse + stringify, con orden de claves estable, sin espacios extra y 100% compatible con parsers estándar. El formato de salida final de una herramienta de Reparar JSON.

Tipos Comunes de Error en Reparación JSON con Ejemplos

Reparar JSON vs Formatear JSON vs Validación JSON Schema

Authoritative References

• IETFEspecificación JSON (RFC 8259)
• MDNJSON.parse - MDN Web Docs
• JSON5JSON5 - Especificación de sintaxis extendida no oficial
• GitHubjsonrepair (josdejong) - Implementación de referencia para navegador y Node