Riparare JSON

Raccomandazioni correlate

Cos'è Riparare JSON (JSON Repair)?

Casi d'uso

• Pulizia output IA/LLM: converti con un clic il JSON di ChatGPT/Claude avvolto in Markdown, con testo esplicativo e virgole finali in JSON standard
• Debug e risoluzione problemi di interfaccia: quando le risposte API vengono troncate da problemi di gateway o rete, completa rapidamente parentesi e stringhe per localizzare la struttura dati originale
• Letterali di oggetto JavaScript copiati dalla console: soluzione unica per apici singoli, virgole finali e chiavi senza apici
• Pulizia file di configurazione: rimuovi i commenti da JSON5/JSONC per ottenere JSON standard, pronto per il consumo unificato a valle
• Riparazione dati di log e appunti: standardizza rapidamente snippet JSON contenenti commenti, spazi speciali o troncamenti
• Migrazione dati e pre-elaborazione di script: aggiungi un passaggio di riparazione nella pipeline di migrazione dati per evitare che pochi JSON invalidi blocchino un intero lotto ETL

Come utilizzare

1. Incolla il contenuto JSON con errori, avvolto in Markdown o troncato nella casella di input sinistra, o fai clic su 'Esempio' per caricare un JSON rotto tipico, o carica un file .json/.txt
2. Lo strumento rileva e ripara automaticamente i problemi di sintassi comuni; l'area di output destra mostra il JSON standard formattato e il conteggio di ogni classe di problema riparato
3. Se rimangono messaggi di errore rossi, puoi modificare manualmente l'input e riattivare la riparazione (Mac: ⌘+Shift+R, Windows: Ctrl+Shift+R)
4. Dopo aver confermato che la struttura è corretta, fai clic su 'Copia' per mettere il risultato riparato negli appunti, o fai clic su 'Scarica' per salvare come repaired.json per ulteriore formattazione, validazione, ecc.

Funzionalità

• Copre 7 errori di sintassi comuni: virgole finali, apici singoli, chiavi senza apici, stringhe non chiuse, commenti, parentesi mancanti, wrapper di blocchi di codice Markdown
• Ottimizzato per la pulizia dell'output IA: rimuove automaticamente wrapper ```json e testo esplicativo circostante; riconosce output tipici di ChatGPT, Claude, Gemini e altri LLM
• Compatibile JSON5/JSONC: analizza sintassi estesa inclusi commenti, apici laschi e spazi speciali (es. caratteri Unicode invisibili)
• Completamento intelligente di JSON troncato: gestisce risposte API troncate e graffe di chiusura mancanti completando automaticamente parentesi e apici mancanti
• Visualizzazione dei problemi riparati: auto-statistiche e mostra il conteggio di ogni classe di problema riparato per facile audit e revisione umana
• Elaborazione locale per la privacy: analisi, riparazione e formattazione avvengono localmente nel browser, nessun input inviato a un server
• Passaggio fluido alla formattazione: il JSON standard riparato può passare direttamente al Formattatore JSON, Validatore Schema o generatore di codice come passi successivi
• Caricamento di file ed esempi: supporta il caricamento di file .json/.txt o il clic per caricare un esempio per la verifica rapida degli effetti della riparazione

Esempi di codice

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

const broken = `{
  name: 'Alice',
  age: 30,
  tags: ['dev', 'writer',], // virgola finale + commento
}`;

try {
  const fixed = jsonrepair(broken);
  const obj = JSON.parse(fixed);
  console.log(obj);
  // => { name: 'Alice', age: 30, tags: ['dev', 'writer'] }
} catch (err) {
  console.error('Ancora non riparabile:', err.message);
}

# pip install jsonrepair
from jsonrepair import jsonrepair
import json

broken = '''{
  name: "Alice",
  age: 30,
  tags: ["dev", "writer",], // virgola finale + commento
}'''

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

# Rimuove le virgole finali da oggetti/array (opzione di emergenza; NON gestisce commenti / apici singoli)
# Per scenari complessi, usa una libreria dedicata come jsonrepair
sed -E 's/,([ \t]*[}\]])/\1/g' broken.json > clean.json

# Valida l'output pulito
jq . clean.json >/dev/null && echo 'JSON è valido'

Domande frequenti

Risoluzione dei problemi

Glossario

JSON

JavaScript Object Notation, formato leggero di scambio dati basato su coppie chiave-valore definito in RFC 8259. Standard di fatto per API REST, file di configurazione e log.

RFC 8259

La specifica JSON ufficiale IETF, che definisce la sintassi stretta del JSON valido - tutte le chiavi devono essere tra apici doppi, solo un insieme limitato di caratteri nelle stringhe necessita escape, commenti e virgole finali non sono permessi.

JSON.parse

Il parser JSON stretto integrato in JavaScript e nei browser moderni, conforme a RFC 8259. Lancia SyntaxError su qualsiasi errore di sintassi e non può eseguire riparazione tollerante.

JSON5

Una sintassi estesa per JSON (non standard), che permette chiavi senza apici, stringhe con apici singoli, commenti (// e /* */), virgole finali, numeri esadecimali, ecc. Più facile da scrivere a mano ma incompatibile con JSON.parse.

JSONC

JSON with Comments, nome generico usato da editor come VS Code per file di configurazione JSON con commenti (es. tsconfig.json). Effettivamente un alias di JSON5.

Virgola finale

Una virgola extra dopo l'ultimo elemento di un oggetto o array. Permessa in JavaScript ma vietata dallo standard JSON - l'errore di sintassi più comune dagli output LLM e dalle copie di console.log().

Blocco di codice Markdown

Uno snippet di codice avvolto in tre backtick (```). Gli LLM spesso avvolgono automaticamente l'output JSON in ```json ... ```; incollarlo direttamente in JSON.parse() fallirà.

Parser tollerante

Un parser che tenta di recuperare e continuare l'analisi quando incontra errori di sintassi. Il motore principale di uno strumento Riparare JSON, distinto dal JSON.parse stretto.

SyntaxError

L'eccezione di errore di sintassi lanciata da JavaScript. Qualsiasi parser JSON stretto la lancia quando riceve input non conforme a RFC 8259.

JSON canonico

JSON rigenerato tramite parse + stringify, con ordine delle chiavi stabile, senza spazi extra e 100% compatibile con parser standard. Il formato di output finale di uno strumento Riparare JSON.

Tipi di Errori Comuni nella Riparazione JSON con Esempi

Riparare JSON vs Formattare JSON vs Validazione JSON Schema

Authoritative References

• IETFSpecifica JSON (RFC 8259)
• MDNJSON.parse - MDN Web Docs
• JSON5JSON5 - Specifica sintassi estesa non ufficiale
• GitHubjsonrepair (josdejong) - Implementazione di riferimento per browser & Node