Tipi TypeScript a partire da dati reali
Scrivere a mano le interfacce della risposta di un’API è lento ed è facile sbagliare un campo. Questo strumento legge un JSON di esempio e genera i tipi TypeScript che lo descrivono.
Ogni oggetto annidato ha una propria interfaccia con un nome ricavato dalla sua chiave (address → Address). Nelle liste di oggetti tutti gli elementi vengono uniti in un solo tipo: se una chiave manca in alcuni, viene segnata come opzionale con «?», e se un campo ha valori di tipo diverso si crea un’unione, come string | number. I tipi identici vengono dichiarati una sola volta.
Puoi scegliere il nome del tipo principale, se usare interface o type, se aggiungere export e se rendere le proprietà readonly.
Come generare tipi TypeScript da JSON
- Incolla un JSON di esempio, come la risposta della tua API.
- Scrivi il nome del tipo principale (predefinito «Root»).
- Scegli interface o type, e se vuoi export e readonly.
- Premi «Genera TypeScript» e copia il codice o scarica il file .ts.
Quando usarlo
- Tipizzare la risposta di un’API REST in un progetto React, Angular, Vue o Node.
- Creare i tipi di un file di configurazione JSON.
- Documentare la forma dei dati scambiati tra due servizi.
- Impostare i modelli di un nuovo progetto partendo da dati di esempio.
Domande Frequenti
Come decide quali campi sono opzionali?
Nelle liste di oggetti, una chiave presente in tutti gli elementi è obbligatoria e una che manca in qualcuno è opzionale (?). Con un solo oggetto di esempio sono tutte obbligatorie; se vuoi rilevare quelle opzionali, incolla una lista con più esempi.
Che tipo assegna a null o a una lista vuota?
Un valore null viene tipizzato come null (o unito al tipo che compare negli altri esempi, come string | null). Una lista vuota diventa unknown[], perché non ci sono esempi per sapere cosa contiene.
Valida i dati in fase di esecuzione?
No. I tipi TypeScript esistono solo in fase di compilazione. Se ti serve una validazione a runtime, usa una libreria come Zod partendo da questi tipi.
I miei dati vengono inviati a un server?
No. Tutto viene elaborato nel tuo browser con JavaScript. Il testo che incolli e i file che apri non lasciano il tuo dispositivo, quindi puoi usare tranquillamente dati interni o dei clienti.
È gratis?
Sì. Puoi provare lo strumento gratis con un documento (incollato o un file) e cambiare le opzioni tutte le volte che vuoi; i tentativi con errori non consumano la prova. Per un uso illimitato e per elaborare più file alla volta, ToolStudio Pro costa 1,99 € al mese e include tutti gli strumenti.