Quando in TypeScript si ripetono dichiarazioni simili, si cerca di calcolare un tipo risultato da quello in ingresso. Conta più la chiarezza della relazione per chi legge che il numero ridotto di caratteri. Un servizio fittizio di notifiche di spedizione introduce tipi condizionali e infer, distinguendoli dalla verifica della correttezza reale di dati esterni.
1. I tipi condizionali sono diramazioni con un tipo in ingresso
La documentazione ufficiale spiega la scelta del risultato tramite extends. L’esempio produce un tipo letterale booleano secondo che il tipo sia stringa. Non è una funzione che esamina stringhe in esecuzione.
type IsText<T> = T extends string ? true : false;
type NameIsText = IsText<'parcel'>; // true
type CountIsText = IsText<3>; // false
Supponiamo che le notifiche ricevano identificatori stringa e l’elaborazione interna numerici. Prima di usare il tipo condizionale bisogna spiegare perché distinguerli. Significati diversi meritano nomi distinti; una semplice differenza di notazione può essere più leggibile unificando l’ingresso. Non nascondete ambiguità del progetto dati dietro tecniche di tipo.
Annotate coppie di ingresso e risultato attesi. Piccoli esempi per stringhe, numeri, unioni e valori inattesi alleggeriscono dichiarazioni complesse. Controllate che commento e tipo dedotto dall’editor coincidano. Un nome naturale non assicura il risultato del calcolo.
2. Distribuire un’unione cambia il significato dell’array
Quando il parametro appare direttamente a sinistra della condizione, questa si distribuisce sui membri dell’unione. Per trattare l’unione intera come unità confrontate la forma tra parentesi quadre.
type SeparateLists<T> = T extends unknown ? T[] : never;
type Together<T> = [T] extends [unknown] ? T[] : never;
type A = SeparateLists<string | number>; // string[] | number[]
type B = Together<string | number>; // (string | number)[]
const a: A = ['a', 'b'];
const b: B = ['a', 1];
Il primo è un array solo di stringhe oppure solo numeri; il secondo ammette entrambi insieme. La scelta dipende dal fatto che l’intera lista richieda un’unica tipologia di codici o tipi diversi per elemento. Le parentesi appaiono in entrambi, ma i contratti non coincidono.
Se emerge un problema, provate un membro alla volta invece di leggere subito tutta l’utilità complessa. Confrontate stringa, numero e unione. Capita la distribuzione voluta, si spiegano le parentesi. Nei controlli conservate esempi di valori ammessi oltre al risultato finale.
3. infer assegna un nome a un tipo dentro una struttura
infer nomina una parte della struttura confrontata nel condizionale. Il piccolo esempio rimuove un livello di Promise.
type OneResult<T> = T extends Promise<infer Value> ? Value : T;
type Parcel = OneResult<Promise<{ tracking: string }>>;
type ParcelList = OneResult<Promise<string[]>>;
Il codice non esegue né attende operazioni asincrone, esprime soltanto la forma durante la compilazione. Resolved come nome può suggerire un valore già arrivato: guardate il contesto d’uso. L’attesa in esecuzione resta nel codice asincrono.
Se occorre il risultato atteso ricorsivamente, controllate l’utilità standard Awaited prima di espandere l’esempio. Semplicità didattica e requisiti di strumenti comuni sono diversi. Per nuove utilità di team documentate ingressi con risultati diversi dallo standard e perché servano.
4. Collegare nomi di eventi con template literal
I tipi template literal rappresentano combinazioni di stringhe letterali. Nel servizio si possono unire ambito e azione per nominare eventi.
type Scope = 'parcel' | 'address';
type Action = 'created' | 'updated';
type EventName = `${Scope}:${Action}`;
const event: EventName = 'parcel:created';
La compilazione trova refusi, ma validità reale di tutte le combinazioni è altra cosa. Se è supportata soltanto l’eliminazione di indirizzi, il prodotto ambito-azione può non esprimere la regola. Valutate prima una corrispondenza esplicita tra eventi ammessi e payload.
Più eventi richiedono che il lettore trovi facilmente i nomi reali. Anziché concatenare molte regole automatiche, potete rendere visibili in un file i nomi inviati a sistemi esterni. Confrontate come un nuovo collega scopre errori prima e dopo l’astrazione. Raffinatezza e usabilità si valutano insieme.
5. Il JSON esterno si controlla in esecuzione
Attribuire User o Parcel a una risposta API non ne garantisce la struttura reale. Ricevete come unknown e controllate i campi necessari in una forma semplice.
function hasTracking(value: unknown): value is { tracking: string } {
return typeof value === 'object' && value !== null
&& 'tracking' in value && typeof value.tracking === 'string';
}
const incoming: unknown = { tracking: 'DEMO-001' };
if (hasTracking(incoming)) console.log(incoming.tracking);
Il controllo conferma solo tracking come stringa, non l’esistenza del numero né il diritto dell’utente a vedere la spedizione. Restringimento del tipo, regole di attività e autorizzazione sono responsabilità diverse. La documentazione Narrowing spiega il restringimento tramite condizioni.
6. Un piccolo ordine di verifica per scegliere gli strumenti
Scrivete prima due valori reali ammessi e due rifiutati. Esprimete il senso con unioni comuni e oggetti espliciti. Se rimangono relazioni ripetute, condizionali e infer hanno un motivo chiaro. Se leggere richiede molto più tempo, estraete solo parti comuni lasciando il resto ordinario.
Eseguite separatamente controlli di tipo e runtime. Il rifiuto di un nome errato dal compilatore e l’errore spiegato quando mancano campi server si completano. Verificate piccoli esempi e poi collegate al vero confine di ingresso perché le trasformazioni aiutino un progetto applicativo sicuro.