JSON in TypeScript
Trasforma un normale esempio JSON in un alias di tipo TypeScript leggibile. Esamina i campi facoltativi e gli array misti, quindi copia il codice o salva un file TypeScript. Il risultato descrive la struttura osservata e necessita di revisione; non convalida i dati futuri in fase di esecuzione.
Genera un tipo da JSON
- Incolla un documento JSON o carica l’esempio. Sono accettati oggetti, array e valori primitivi alla radice entro i limiti previsti. Commenti, virgole finali, chiavi duplicate dopo la decodifica e surrogati UTF-16 senza coppia vengono rifiutati.
- Scegli un nome di tipo radice che inizia con una lettera maiuscola ASCII, seguita da lettere, cifre o trattini bassi, fino a 64 caratteri. Seleziona due o quattro spazi e Genera tipo.
- Esaminare i campi dedotti e la qualifica del solo campione. Copia scrive solo il codice corrente; Scarica TypeScript salva lo stesso codice UTF-8 di json-types.ts. La modifica di un input cancella il vecchio risultato.
Come funziona l'inferenza del campione
I valori primitivi diventano null, boolean, number o string. Le stringhe simili a date, identificatori o numeri restano stringhe. I token numerici sono classificati senza conversione; number non garantisce precisione numerica in JavaScript.
Gli oggetti nello stesso contesto vengono raggruppati. Una chiave è facoltativa quando manca in almeno un oggetto del gruppo. Un null esplicito è un valore: facoltativo e nullable sono concetti diversi. Anche gli oggetti vuoti vengono considerati.
Gli array combinano ricorsivamente gli elementi osservati, senza creare tuple di lunghezza fissa. Gli array vuoti possono usare gli elementi di array non vuoti nello stesso contesto; se non ci sono elementi, il risultato è unknown[]. Percorsi di proprietà diversi non condividono dati.
Il risultato è un alias di tipo esportato con tipi annidati in linea, chiavi tra virgolette e formattazione stabile. Un pool di oggetti senza chiavi utilizza una firma dell'indice di stringa con valore unknown, che è permissiva anziché esatta-vuota. Non viene applicata alcuna enumerazione, discriminante, dizionario, data o euristica UUID.
Esempi obbligatori, facoltativi e nullable
Nell’esempio, il primo oggetto ha id 1, label Ada e score null; il secondo ha id 2 e score 4. id e score compaiono in entrambi e sono obbligatori. label compare una volta e diventa facoltativo. score combina null e number.
Per un oggetto il cui campo left è un array vuoto e il campo right contiene 1, left rimane unknown[] e right diventa number[] . Per due array items corrispondenti, uno vuoto e uno contenente 1, l'evidenza dell'elemento condiviso produce invece number[] .
Unendo oggetti con kind ok e value e oggetti con kind error e message, kind diventa una stringa e value e message diventano facoltativi. La relazione originale si perde e sono ammesse combinazioni non osservate. Verifica questi casi se ti serve una union discriminata.
Inferenza e limiti dimensionali
Un campione non può stabilire ogni campo futuro, valore mancante o variante. Le dichiarazioni generate sono tipi in fase di compilazione, non un validatore di runtime, uno schema di oggetto esatto o una prova che una risposta API è corretta.
L'input è limitato a 256 KiB di testo UTF-8, profondità 32 e 20000 record. Ogni valore JSON conta una volta e ogni membro dell'oggetto aggiunge altri due record. L'output è limitato a 1 MiB inclusa la formattazione e il ritorno a capo finale. I limiti rifiutano l'intera operazione senza un risultato troncato.
È consentito un solo BOM iniziale. I nomi duplicati dopo la decodifica e i surrogati UTF-16 senza coppia vengono rifiutati per interoperabilità. I token numerici possono avere fino a 1024 caratteri e un esponente di valore assoluto fino a 100000; non si deducono bigint né garanzie di precisione.
Lo strumento accetta testo JSON ed emette un alias di tipo. Non importa file o URL, non esegue esempi, non genera interfacce o codice runtime, non deduce schemi JSON, non traduce chiavi né installa un compilatore nel browser. Esamina le dichiarazioni nel progetto TypeScript in cui le utilizzerai.
Gli esempi e il codice rimangono nel flusso di lavoro di questa pagina
Lo strumento non invia l’esempio a un server, non salva la cronologia, non crea link con i dati inseriti e non aggiunge telemetria contenente JSON, chiavi, nomi di tipo o codice generato. Copia e download avvengono su richiesta. Servizi esistenti del sito, estensioni e uso successivo del codice non sono inclusi in questa descrizione.
Domande da JSON a TypeScript
Fonti e riferimenti
- rfc-editor.orgRFC 8259Sintassi JSON e interoperabilità.
- typescriptlang.orgTypeScript: Everyday TypesAlias, array e unioni di TypeScript.
- typescriptlang.orgTypeScript: Object TypesProprietà degli oggetti e firme degli indici.
- typescriptlang.orgTypeScript: unknownIl tipo unknown per valori senza informazioni osservate.
- typescriptlang.orgTypeScript: Erased TypesLe dichiarazioni di tipo non forniscono la convalida di runtime.
Fonti esaminate il 2026-11-15. Raggruppamento, nomi e limiti sono scelte dello strumento.
Strumenti correlati
Da JSON a YAML
Converti JSON in YAML localmente, conservando il testo dei numeri e le stringhe tra virgolette; copia o scarica il risultato completo.
Apri strumento — Da JSON a YAMLConvertitore da YAML a JSON
Converti YAML in JSON localmente con testo numerico esatto, alias limitati e copia o download completi.
Apri strumento — Convertitore da YAML a JSONFormattatore YAML
Sistema i rientri del codice YAML e copia il risultato verificato, conservando commenti e dettagli del sorgente.
Apri strumento — Formattatore YAMLFormattatore XML
Controlla XML 1.0 con i relativi spazi dei nomi, formatta o compatta in locale e copia o scarica il risultato UTF-8.
Apri strumento — Formattatore XMLFormattatore e validatore JSON
Verifica la sintassi JSON, formatta o minimizza in locale e copia o scarica il risultato preservando i dati originali.
Apri strumento — Formattatore e validatore JSON