Tipi di dati TypeScript: il riferimento completo
Tipi di dati TypeScript
Tipi di dati TypeScript: ogni tipo in una tabella cercabile | We.Inc
string, number, boolean, bigint, symbol, null, undefined, any, unknown, never, void, object, array, tuple, enum, tipi letterali e union, con un esempio per ciascuno.
I tipi di dati di base di TypeScript sono i sette primitivi di JavaScript, string, number, bigint, boolean, symbol, null e undefined, scritti in minuscolo. A questi aggiunge tipi speciali (any, unknown, never, void, object), strutture come array, tuple ed enum, e modi per combinare i tipi: tipi letterali, union e intersection.
I quattro gruppi
- Gruppo
- Tipi
- Usalo per
- Primitivi
- string, number, bigint, boolean, symbol, null, undefined
- Valori singoli
- Speciali
- any, unknown, never, void, object
- Descrivere i limiti del sistema di tipi
- Strutture
- Array, tuple, enum, tipi oggetto
- Gruppi di valori
- Combinazioni
- Tipi letterali, union, intersection
- Forme precise o flessibili
Cerca nel riferimento per nome o filtralo per gruppo. Ogni riga ha un esempio di una riga che puoi incollare in un file .ts, e la colonna delle note segnala i comportamenti che mettono in difficoltà, come la differenza tra void e undefined o perché unknown è più sicuro di any.
- Scrivi nella casella di ricerca per trovare il nome di un tipo, un esempio o una nota.
- Usa i pulsanti dei gruppi per mostrare solo primitivi, tipi speciali, strutture o combinazioni.
- Leggi l'esempio e la nota in ogni riga; il contatore sopra la tabella indica quante righe corrispondono.
- Segui le guide correlate su enum, interface e Record quando una riga richiede più approfondimento.
- Scrivi string, number e boolean in minuscolo. String, Number e Boolean con l'iniziale maiuscola sono tipi wrapper oggetto e raramente sono ciò che vuoi.
- Tipizza come unknown i valori che arrivano da fuori dal tuo codice, come JSON e input dei form, poi restringili. any spegne il controllo su tutto ciò che tocca.
- Lascia lavorare l'inferenza per le variabili locali. Annota i parametri delle funzioni, i tipi di ritorno delle funzioni esportate e gli array o le Map vuoti.
- In uno switch su una union, aggiungi un ramo default che assegna a never. Il giorno in cui qualcuno aggiunge un membro, la build indica ogni switch che lo ha dimenticato.
Domande frequenti
Quanti tipi primitivi ha TypeScript?
Sette, gli stessi di JavaScript: string, number, bigint, boolean, symbol, null e undefined. number copre sia gli interi sia i decimali; non esiste un tipo int o float separato.
Qual è la differenza tra any e unknown?
Entrambi accettano qualsiasi valore. any ti lascia fare qualsiasi cosa, quindi gli errori passano inosservati. unknown non ti lascia fare nulla finché non lo restringi con un controllo come typeof, ed è per questo la scelta sicura per dati non fidati.
A cosa serve il tipo never?
never descrive valori che non possono esistere: il tipo di ritorno di una funzione che lancia sempre un'eccezione, e ciò che resta di una union dopo che ogni membro è stato gestito. Questo secondo uso rende possibili i controlli di esaustività.
void è la stessa cosa di undefined?
No. void è il tipo di ritorno di una funzione il cui valore restituito va ignorato. A una funzione tipizzata con ritorno void si può passare una callback che restituisce qualcosa, mentre undefined significa che il valore è davvero undefined.
Qual è la differenza tra object, Object e {}?
object indica qualsiasi valore non primitivo, come oggetti, array e funzioni. {} indica qualsiasi valore tranne null e undefined, primitivi inclusi. Il tipo globale Object è raramente utile; preferisci object o un tipo oggetto specifico.
Primitivi: cosa riporta typeof
- I tipi primitivi in minuscolo corrispondono a ciò che l'operatore typeof di JavaScript riporta a runtime, ed è per questo che i controlli con typeof li restringono in modo così pulito. null è l'eccezione: typeof null è "object", quindi controllalo con === null.
- bigint richiede un target di compilazione ES2020 o successivo per la sintassi letterale 123n. I valori symbol sono unici anche quando vengono creati con la stessa descrizione.
I tipi speciali segnano i limiti
- any e unknown stanno in cima: ogni valore ci entra. never sta in fondo: nessun valore ci entra, e lui entra in ogni altro tipo. void riguarda i valori di ritorno, e object serve a escludere i primitivi.
- Sapere a quale limite ti trovi rende leggibili i messaggi del compilatore. Un errore che menziona never dopo un narrowing di solito indica un ramo che il codice ritiene non possa mai essere eseguito.
Combinare i tipi
- Un tipo letterale restringe un primitivo a valori esatti, come "left" | "right". Una union dice che un valore è uno tra diversi tipi; una intersection dice che è tutti insieme, ed è così che si uniscono due tipi oggetto.
- Le union di letterali stringa sostituiscono spesso gli enum, perché vengono cancellate del tutto e si leggono in modo naturale nel codice. La guida sugli enum di questo sito confronta le due soluzioni.
Da unknown a un tipo utilizzabile
Restringi l'input non fidato passo dopo passo
Ogni controllo elimina delle possibilità. Dentro l'ultimo ramo il compilatore sa che value è una stringa.
never come controllo di esaustività
Se un nuovo stato si aggiunge alla union, l'assegnazione a never smette di compilare finché non aggiungi un case per esso.
Testo di qualsiasi lunghezza. Anche i template literal sono stringhe.
Interi e decimali allo stesso modo, inclusi NaN e Infinity.
Numeri interi oltre l'intervallo degli interi sicuri. Il suffisso n richiede un target ES2020.
Solo true o false.
Ogni chiamata a Symbol() crea un valore unico.
Con strictNullChecks attivo, null deve essere elencato nel tipo per essere ammesso.
Il valore di una variabile dichiarata ma non assegnata e di una proprietà opzionale mancante.
Disattiva il controllo sul valore. noImplicitAny segnala i punti in cui si insinua senza preavviso.
Contiene qualsiasi valore ma non permette nulla finché non lo restringi.
Nessun valore ha mai questo tipo: funzioni che lanciano sempre, e union senza più nulla dentro.
Un valore di ritorno da ignorare. Non è la stessa cosa di undefined.
Qualsiasi non primitivo: oggetti, array e funzioni.
Array
string[] e Array<string> significano la stessa cosa.
Array readonly
Equivale a ReadonlyArray<number>. push e gli altri metodi che modificano vengono rimossi.
Tuple
Lunghezza fissa con un tipo per posizione. Gli elementi opzionali vanno alla fine: [number, number?].
Genera un vero oggetto a runtime, a differenza della maggior parte della sintassi TypeScript.
Tipo oggetto
Descrive le proprietà inline. Dagli un nome con type o interface per riutilizzarlo.
Tipo funzione
Tipi dei parametri e del ritorno. Preferiscilo al generico tipo Function.
Tipo letterale
Valori esatti invece dell'intero primitivo.
Union
Uno tra diversi tipi. Restringi con typeof, in o un campo comune prima di usare i membri.
Intersection
Tutti i tipi insieme. Usata soprattutto per unire tipi oggetto.
Primitivi
Speciali
Strutture
Combinazioni
Riferimento dei tipi cercabile
Cerca tipi
unknown, tuple, null...
Filtra per gruppo
Tutti
Mostrati {n} tipi su {v}
Nessun tipo corrisponde alla ricerca.
Tipi TypeScript con esempi
Tipo
Gruppo
Esempio
Nota
Crea il tuo sito gratis · Gratis per creare, senza carta
Correlati: Guide
- Enum in TypeScript e le loro alternative
- Interface TypeScript
- Cicli in TypeScript e i tipi che ti danno
- Map in TypeScript
- Il tipo Record di TypeScript spiegato con le tue chiavi
- TypeScript vs JavaScript
- User Flow e Wireframe per Siti Web, SVG Gratuiti
- UUID v4 vs v7
Prodotto
Per chi è
- Per le agenzie
- Per i freelance
- Per i provider di hosting
- Per le piattaforme SaaS
- Per le startup
- Servizi finanziari
- Soluzioni per la sanità
Funzionalità
Risorse
- Blog
- Centro assistenza
- Strumenti gratuiti per le aziende
- Free UI Components
- Template
- Raccolte di template
- Esempi di siti
- Guide
- Confronti
- Alternative
- I migliori
- Recensioni
- Guide ai prezzi
- Casi d'uso
- Glossario e guide
- Integrazioni
- Sviluppatori
- Benchmark
- Windows App