JSON a dattiloscritto

Il convertitore da JSON a TypeScript legge un valore JSON di esempio - una risposta API, un file di configurazione, un record di database - e scrive le interfacce TypeScript che lo descrivono Gli oggetti nidificati diventano le loro interfacce con nome, gli array di oggetti vengono uniti in un'interfaccia a elemento singolo anziché in un'unione estesa e le chiavi nulle o mancanti in alcuni record sono contrassegnate come opzionali Incolli i dati che hai già; ottieni tipi che altrimenti scriveresti a mano.

Digitando a mano una risposta API è noioso e soggetto a errori in un modo specifico: si digita ciò che *pensi* restituisce l'endpoint, non quello che effettivamente restituito. I campi che non hai mai notato vengono omessi, un numero intero che a volte viene digitato come `numero` e l'errore emerge in fase di esecuzione in fase di produzione anziché nel tuo editor. La generazione di tipi direttamente da un carico utile reale chiude quel divario, perché la forma su cui si compila è la forma effettivamente inviata dal server.

Tutto viene eseguito nel tuo browser Il motore di inferenza è TypeScript senza dipendenze, non un wrapper attorno a un servizio remoto, quindi i payload - che trasportano abitualmente token di accesso, record dei clienti e ID interni - non lasciano mai la pagina Scegli interfacce o digita alias, attiva/disattiva la parola chiave `export`` e i modificatori `readonly`, scegli la larghezza del rientro, quindi copia l'output o scarica un file.ts.

Le interfacce generate descrivono il campione fornito, non l'API che stai chiamando, e quella distinzione è l'intero rischio Un campo che capita di essere presente in ogni oggetto del tuo campione è contrassegnato richiesto anche se il server lo omette a volte, e un campo che è nullo nel campione non può essere distinto da uno che è sempre nullo Gli array vuoti sono il caso più chiaro: un array senza elementi non dà informazioni su ciò che contiene L'unione dell'array aiuta qui combinando ogni oggetto in un elenco in un'unica interfaccia e contrassegnando le chiavi che mancano da alcune voci come facoltative, quindi un campione più grande e vario produce un tipo più onesto Dove l'API ha uno schema o un documento OpenAPI, genera da quello invece e usa questo per esplorare una risposta non documentata.