Da JSON a TypeScript

Cosa fa Da JSON a TypeScript

Da JSON a TypeScript legge un esempio JSON e deduce interfacce TypeScript fortemente tipizzate che ne descrivono la struttura. Percorre il valore in modo ricorsivo: gli oggetti diventano interfacce con nome, i valori primitivi diventano i tipi corrispondenti string, number, boolean o null, e gli array diventano tipi di elemento racchiusi tra parentesi quadre. Quando un array contiene elementi di tipo diverso, il generatore li unisce in un'unione, così il risultato continua a essere compatibile con i dati originali. È utile quando si utilizza un'API senza tipi pubblicati, quando si aggiunge sicurezza dei tipi a un payload legacy o quando si trasforma una rapida fixture in un modello riutilizzabile.

Gli array di oggetti sono gestiti con cura. Invece di tipizzare solo il primo elemento, lo strumento unisce tutti gli oggetti dell'array in una sola interfaccia, raccogliendo l'unione delle chiavi. Le chiavi assenti in alcuni elementi vengono marcate come opzionali con un punto interrogativo finale, rispecchiando il modo in cui le risposte reali includono i campi solo quando sono valorizzati. Gli oggetti annidati diventano interfacce con nome proprio, derivato dal nome della proprietà, così l'output sembra scritto a mano e non un unico tipo profondamente inline.

Flusso di lavoro privato nel browser

Tutto il parsing e l'inferenza avvengono nel tuo browser con JavaScript lato client. Lo strumento non carica su alcun server il tuo JSON, le risposte delle API, gli identificatori, i token o esempi simili ai dati dei clienti e non richiede alcun account. Questo modello esclusivamente locale è importante perché i dati incollati in un generatore di tipi sono spesso una vera risposta di produzione catturata durante il debug. Mantenere il lavoro sul tuo computer riduce i rischi e rende il risultato istantaneo, perché non c'è alcun viaggio di rete tra incolla e output.

L'interfaccia tiene vicini l'input JSON, il nome della radice e le interfacce generate, così puoi verificare l'inferenza prima di copiarla. I risultati vanno comunque rivisti prima di essere inseriti nel codice: un singolo esempio non può rivelare ogni campo opzionale, valore nullable o enum che l'API reale può restituire, quindi allarga i tipi dove la tua conoscenza del dominio indica che un campo può mancare o assumere più forme di quelle mostrate dall'esempio.

Consigli pratici

Fornisci l'esempio più completo a disposizione, idealmente con i campi opzionali valorizzati e un array con più di un elemento, in modo che la logica di unione possa rilevare unioni e opzionalità. Rinomina l'interfaccia radice in base al tuo modello di dominio prima di generare. Dopo la copia, valuta di restringere i tipi dedotti in modo troppo generico: sostituisci i campi string troppo ampi con unioni di letterali per gli enum noti, segna gli identificatori come branded type se il tuo codice li usa e verifica che ogni campo dedotto come null debba invece essere un'unione nullable. L'inferenza nel browser è eccellente per una prima bozza rapida, ma i tipi finali devono riflettere il contratto da cui la tua applicazione dipende davvero.