Parser JSON

JSON (JavaScript Object Notation) e il formato standard di interscambio dati per API web e file di configurazione. Questo strumento analizza, valida e formatta JSON con una vista ad albero interattiva per esplorare strutture annidate. Converte tra JSON e altri formati come YAML o TOML.

Specifiche

• RFC 8259 - The JSON Data Interchange Format
• ECMA-404 - The JSON Data Interchange Syntax
• JSON.org

Casi d'uso comuni

• Formattazione di risposte API minificate per il debug
• Validazione di file di configurazione JSON prima del deploy
• Conversione di risposte API in YAML per la documentazione
• Esplorazione di strutture dati profondamente annidate dai database NoSQL
• Preparazione di payload JSON per strumenti di test API come Postman o curl

Funzionalità

• Validazione della sintassi JSON con messaggi di errore chiari e numeri di riga
• Formattazione con indentazione a 2 spazi
• Minificazione JSON per archiviazione o trasmissione compatta
• Conversione in formati YAML, TOML o XML
• Vista ad albero interattiva con nodi comprimibili
• Copia di valori individuali o sotto-alberi

Esempi

{
  "users": [
    {
      "id": 1,
      "name": "Alice",
      "email": "alice@example.com"
    },
    {
      "id": 2,
      "name": "Bob",
      "email": "bob@example.com"
    }
  ],
  "total": 2
}

{
  "database": {
    "host": "localhost",
    "port": 5432,
    "name": "myapp"
  },
  "cache": {
    "enabled": true,
    "ttl": 3600
  }
}

Suggerimenti

• Le chiavi JSON devono essere stringhe tra doppi apici. I singoli apici non sono validi.
• Le virgole finali dopo l'ultimo elemento non sono consentite nel JSON standard.
• Per JSON con commenti, usa invece il parser JSONC.

Approfondimenti Parser JSON

JSON (JavaScript Object Notation) e il formato universale di interscambio dati del web moderno. Definito da RFC 8259 e ECMA-404, JSON rappresenta dati strutturati usando sei tipi: stringhe, numeri, booleani, null, array e oggetti. La sua semplicita e la corrispondenza diretta con le strutture dati in praticamente ogni linguaggio di programmazione lo hanno reso il formato predefinito per le API REST, i file di configurazione, i database documentali e la comunicazione tra servizi.

La sintassi di JSON e un sottoinsieme rigoroso della notazione letterale degli oggetti JavaScript, ma con restrizioni importanti: le chiavi devono essere stringhe tra doppi apici, le virgole finali non sono consentite e i commenti non sono supportati. Questi vincoli garantiscono un'analisi non ambigua tra le implementazioni. Un documento JSON valido deve avere un oggetto o un array come elemento radice (anche se l'RFC 8259 tecnicamente consente qualsiasi valore JSON al livello superiore, la maggior parte delle API si aspetta un oggetto o un array).

Nello sviluppo web, JSON e il formato standard di richiesta e risposta per le API REST e GraphQL. I browser forniscono i metodi nativi JSON.parse() e JSON.stringify(), e l'API fetch include un metodo di comodita .json(). I framework server in Node.js, Python (Flask, Django), Go e altri linguaggi includono tutti la serializzazione JSON integrata. I database documentali come MongoDB, CouchDB e DynamoDB archiviano i dati nativamente in JSON o formati simili a JSON (BSON per MongoDB).

Le limitazioni di JSON hanno generato diverse estensioni e alternative: JSONC aggiunge commenti per i file di configurazione, JSON5 rilassa le regole di sintassi, JSON Lines (JSONL/NDJSON) usa un oggetto JSON per riga per lo streaming, e JSON Schema fornisce un vocabolario per validare la struttura dei documenti JSON. Per l'efficienza binaria, formati come BSON, MessagePack e CBOR offrono una serializzazione compatta compatibile con JSON. Nonostante queste alternative, il JSON semplice rimane il formato dominante grazie al suo supporto universale degli strumenti e alla leggibilita umana.

JSON intenzionalmente non supporta i commenti. Douglas Crockford, che ha reso popolare il formato, li ha esclusi per mantenerlo semplice e per prevenire il loro uso improprio come direttive di analisi (come successo in XML). Per i file di configurazione dove la documentazione inline e necessaria, JSONC (JSON with Comments) e supportato nativamente da strumenti come VS Code, TypeScript e ESLint. YAML e TOML sono anche valide alternative quando i file di configurazione beneficiano di commenti, stringhe multiriga o intestazioni di sezione chiare.

Nonostante le sue origini in JavaScript, JSON non e uguale a un oggetto letterale JavaScript. JSON impone regole di sintassi rigorose: tutte le chiavi devono essere tra doppi apici, sono consentite solo stringhe tra doppi apici, le virgole finali sono vietate e valori come undefined e funzioni non possono essere rappresentati. JSON.parse() converte una stringa JSON in un oggetto JavaScript, mentre JSON.stringify() serializza un oggetto in una stringa JSON. Non tutti gli oggetti JavaScript possono fare il round-trip attraverso JSON: quelli contenenti funzioni, undefined, Infinity o riferimenti circolari perderanno dati o genereranno errori durante la serializzazione.

Per file JSON piu grandi di qualche megabyte, caricare l'intero documento in memoria tutto in una volta puo causare problemi di prestazioni. I parser in streaming, librerie in stile SAX come clarinet e oboe.js per JavaScript, o ijson per Python, elaborano il documento in modo incrementale senza bufferizzare l'intera struttura. Il formato JSON Lines (JSONL), dove ogni riga e un oggetto JSON separato, e ideale per grandi dataset perche i record possono essere elaborati uno alla volta. Le API che restituiscono risposte grandi dovrebbero implementare la paginazione per mantenere gestibili le dimensioni delle singole risposte. Quando si sceglie tra JSON e altri formati, JSON e il valore predefinito piu sicuro per la comunicazione API e lo scambio dati perche ogni linguaggio e strumento lo supporta senza dipendenze aggiuntive. YAML eccelle per la configurazione modificata dagli umani, come i manifest Kubernetes e le pipeline CI/CD. TOML e il migliore per la configurazione delle applicazioni che beneficia di intestazioni di sezione esplicite e semplici coppie chiave-valore, come Cargo.toml e pyproject.toml.