Da JSON a TypeScript
Trasforma un esempio di JSON in interfacce TypeScript, con gli oggetti annidati estratti in tipi con un nome proprio.
Cosa fa
Da JSON a TypeScript legge davvero l'input e lo riscrive nel formato di destinazione, invece di lavorare a forza di sostituzioni. La struttura viene mantenuta dove il formato di arrivo sa esprimerla, e appiattita in modo prevedibile dove non può.
Quando serve
Quando i dati devono passare tra cose che non si parlano: un'API che risponde in un formato, un foglio di calcolo che ne apre un altro, un file di configurazione che un programma si rifiuta di leggere, un export che deve diventare un import.
Limiti e avvertenze
I formati non sono equivalenti, quindi qualcosa si perde per strada: le strutture annidate vanno appiattite per una tabella, e commenti e distinzioni di tipo spariscono in entrambe le direzioni. Un input non valido viene segnalato, non indovinato. Tutto avviene nel tuo browser, quindi il file non lascia mai il tuo dispositivo.
Come funziona
- Incolla una risposta vera dell'API che stai tipizzando.
- Gli oggetti annidati diventano interfacce a sé, gli array prendono il tipo degli elementi.
- Copia il risultato nel tuo progetto.
Domande frequenti
- Cosa succede agli array di tipi misti?
- Ottieni un'unione, per esempio (string | number)[]. Tirare a indovinare dal primo elemento è il modo in cui i generatori producono tipi che si rompono in produzione.
- Perché i campi null diventano opzionali?
- Perché un null in una risposta d'esempio quasi sempre vuol dire che il campo può mancare o essere vuoto. Spegni l'interruttore se la tua API manda davvero null ogni volta.
- Un esempio non è tutta l'API.
- Esatto, ed è il limite onesto di questo approccio. Un campo assente dal tuo esempio non può comparire nei tipi. Incolla la risposta più completa che hai.
- I miei file vengono caricati da qualche parte?
- No. Questo strumento funziona interamente nel tuo browser, quindi il file non lascia mai il tuo dispositivo.