Formattatore JSON vs JSON Repair

Un formattatore rende più leggibile un JSON valido. Uno strumento di riparazione cerca di trasformare «quasi JSON» in JSON valido prima di formattarlo.

Formatter

Un formatter JSON si aspetta un input JSON valido. Parsi il documento e lo stampi con indentazione, ritorni a capo e spaziatura coerenti. I formatter sono ideali per log leggibili, risposte di API, fixture, file di configurazione e per rivedere oggetti annidati che già parsano correttamente.

Validator

Un validator risponde a una sola domanda: è JSON strict? Deve fallire subito su commenti, apici singoli, chiavi senza virgolette, virgole finali, letterali Python e altre sintassi non JSON. La validazione è il primo passo giusto quando vuoi avere la certezza che un altro parser accetti il documento.

Strumento di repair

Uno strumento di repair è pensato per il «quasi-JSON»: dati con una struttura chiara ma con sintassi tipo JavaScript, Python, markdown o commenti umani. Il repair può convertire il testo in JSON strict e poi formattare il risultato per esaminarlo più facilmente.

Minifier

Un minifier rimuove gli spazi superflui da JSON valido. Non corregge errori di sintassi. Usa la minificazione quando conta la dimensione del payload o quando copi un valore compatto in una variabile d’ambiente, un parametro di query o un esempio da riga di comando.

Quale strumento scegliere

Usa Validate quando ti serve un sì/no. Usa Format quando l’input è valido ma difficile da leggere. Usa Repair quando JSON.parse fallisce e la sorgente è un letterale di oggetto JavaScript, una risposta di LLM, una configurazione commentata o uno snippet editato a mano. Usa Diff quando hai due documenti validi o riparati e devi capire cosa è cambiato.

Rischio del repair automatico

Gli strumenti di repair possono sistemare la sintassi, ma non dovrebbero decidere il significato di business. Se il repair tocca solo virgolette, commenti o virgole, l’intento di solito è chiaro. Se invece deve indovinare una parentesi mancante, un nome di campo o un valore, rivedi l’output con attenzione prima di usarlo in produzione.

Flusso pratico

Per input disordinati: prima ripara, poi formatta, poi valida, e confronta con un esempio noto se il payload guida il comportamento dell’app. Questa sequenza ti dà output leggibili senza saltare il controllo finale con un parser strict.