Vai al contenuto

Da JSON a TypeScript

Trasformate un campione JSON in interfacce o alias di tipo TypeScript. Gli oggetti annidati diventano tipi con un proprio nome, gli array di oggetti vengono uniti così che le chiavi mancanti in alcuni elementi siano facoltative e i valori misti diventano tipi unione. Incollate una risposta API, scegliete interfaccia o tipo e copiate le dichiarazioni da inserire direttamente nel vostro codice.

Reimposta

Domande frequenti

Come vengono gestiti gli oggetti annidati?

Ogni oggetto annidato genera una propria dichiarazione, denominata in PascalCase in base alla chiave che lo contiene; per esempio, address diventa Address. Gli oggetti negli array prendono il nome dalla forma singolare della chiave dell’array: users diventa User e categories diventa Category. Gli oggetti con esattamente gli stessi campi condividono una dichiarazione.

Quando una proprietà diventa facoltativa?

Quando un array contiene più oggetti e una chiave manca in alcuni di essi, la chiave viene contrassegnata come facoltativa con un punto interrogativo. Le chiavi presenti in ogni elemento restano obbligatorie. Un singolo oggetto non ha altri campioni con cui confrontarsi, quindi tutte le sue chiavi sono obbligatorie.

Come vengono tipizzati i valori null?

Una chiave con valore null nel campione viene tipizzata come null; se invece ha valore null in alcuni elementi e una stringa in altri, diventa string | null. Se un campo può essere null nei dati reali ma non lo è mai nel campione, aggiungete null a mano oppure incollate un campione che lo includa.

È meglio scegliere interface o type?

Entrambi descrivono la stessa struttura. Le interfacce possono essere estese e unite, caratteristiche che molte guide di stile preferiscono per le strutture degli oggetti; gli alias di tipo funzionano anche con le unioni e alcuni team li usano ovunque. Scegliete quello usato nel vostro codebase: i campi sono identici.

Come vengono tipizzati gli array?

Un array di valori dello stesso tipo diventa quel tipo seguito da [], per esempio string[] o User[]. Un array con più tipi diventa un’unione tra parentesi, per esempio (string | number)[]. Un array vuoto diventa unknown[], perché il campione non fornisce informazioni sui suoi elementi.

Che succede alle chiavi che non sono identificatori validi?

Le chiavi con spazi, trattini o altri caratteri non consentiti in un identificatore TypeScript vengono racchiuse tra virgolette, per esempio "first-name": string, che è valido TypeScript e corrisponde esattamente a JSON.

I numeri vengono tipizzati come interi o decimali?

TypeScript ha un solo tipo numerico, quindi sia gli interi sia i decimali diventano number. Se dovete distinguere i valori interi, il generatore di schemi JSON distingue integer da number.

Posso rinominare il tipo radice?

Sì. Inserite un nome per il tipo radice, per esempio ApiResponse. Verrà convertito in PascalCase e i tipi annidati manterranno i nomi derivati dalle rispettive chiavi. Se il livello superiore del vostro JSON è un array o un singolo valore, la radice diventa un alias di tipo.

Le date vengono rilevate?

No. JSON non ha un tipo data, quindi una data nel campione è una stringa e viene tipizzata come string. Dopo l’analisi, convertitela in Date nel vostro codice oppure restringete il tipo a mano se usate un tipo letterale di modello.

Quali sono le dimensioni massime di JSON?

Fino a 1,000,000 caratteri e 64 livelli di annidamento. Il campione viene analizzato solo per generare i tipi e non viene memorizzato.

Informazioni su OneClick Pro

OneClick Pro è una raccolta gratuita di oltre 150 strumenti web per le attività quotidiane: convertire immagini e unità di misura, formattare e convalidare codice, controllare domini e SEO, lavorare con testi, date e numeri. Ogni strumento funziona senza registrazione né abbonamento; i dati inseriti vengono usati solo per calcolare il risultato e non vengono mai salvati. Usatelo come cassetta degli attrezzi per attività occasionali oppure aggiungete ai preferiti gli strumenti che usate ogni giorno.