0Pricing
TypeScript Academy · Lezione

Tipi literal stringa e numerici

Limiti i valori a stringhe e numeri esatti utilizzando i tipi literal.

Tipi literal stringa e numerici è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento TypeScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso TypeScript Academy include 4 lezioni in totale.

Che cos'è un tipo letterale

La maggior parte dei tipi descrive un insieme di valori. string indica una stringa qualsiasi, mentre number indica un numero qualsiasi. Un tipo letterale restringe l'insieme a un unico valore preciso.

Il tipo 'north' consente soltanto la stringa 'north', e nient'altro. I tipi letterali permettono di modellare insiemi precisi e finiti di valori consentiti direttamente nel sistema dei tipi.

let dir: 'north' = 'north';
console.log(dir);
// dir = 'south'; // Error: not assignable to type 'north'

Unioni di stringhe letterali

Un singolo letterale non è molto utile da solo. Ne può combinare diversi con | per formare una unione di letterali. Questo è il modo idiomatico per modellare un insieme fisso di opzioni.

Direction può avere soltanto una di quattro stringhe precise.

type Direction = 'north' | 'south' | 'east' | 'west';

let heading: Direction = 'east';
console.log('Heading:', heading);

heading = 'west';
console.log('Now:', heading);

Rifiutare i valori non validi

Il vantaggio delle unioni di letterali è che il compilatore rifiuta qualsiasi valore al di fuori dell'insieme consentito. Gli errori di battitura e le opzioni non valide diventano errori in fase di compilazione anziché bug a runtime.

type Direction = 'north' | 'south' | 'east' | 'west';

let heading: Direction = 'north';
console.log(heading);
// heading = 'up'; // Error: '"up"' is not assignable to 'Direction'

Letterali come parametri di funzione

Usi le unioni di letterali per i parametri di funzione che accettano soltanto valori specifici. Chi chiama la funzione riceve il completamento automatico e non può passare valori non validi.

type Direction = 'north' | 'south' | 'east' | 'west';

function move(dir: Direction): string {
  return 'Moving ' + dir;
}

console.log(move('south'));
// console.log(move('left')); // Error

Tipi letterali numerici

I tipi letterali non servono soltanto per le stringhe. Può usare anche numeri precisi. Un esempio classico è un dado a sei facce, il cui valore deve essere compreso tra 1 e 6.

type Dice = 1 | 2 | 3 | 4 | 5 | 6;

function roll(): Dice {
  return (Math.floor(Math.random() * 6) + 1) as Dice;
}

console.log('Rolled:', roll());

Letterali numerici nei parametri

Le unioni di letterali numerici limitano gli input a un insieme preciso di numeri: sono perfette per livelli di qualità, codici simili a quelli HTTP o dimensioni di griglie.

type Quality = 1 | 2 | 3;

function setQuality(level: Quality): void {
  console.log('Quality set to', level);
}

setQuality(2);
// setQuality(5); // Error: 5 is not 1 | 2 | 3

Combinare letterali stringa e numerici

Un'unione può combinare diversi tipi di letterali. È utile per le API che accettano una preimpostazione denominata oppure un valore diretto.

type Size = 'small' | 'large' | 0 | 100;

function resize(s: Size): void {
  console.log('Resizing to', s);
}

resize('small');
resize(100);

Tipi letterali booleani

Anche i booleani hanno tipi letterali: true e false sono sia tipi sia valori. Il tipo completo boolean è in realtà semplicemente true | false.

type AlwaysOn = true;

let enabled: AlwaysOn = true;
console.log('Enabled:', enabled);
// enabled = false; // Error: false not assignable to true

I letterali migliorano la documentazione

Un'unione di letterali funge anche da documentazione. Chiunque legga type Status = 'idle' | 'loading' | 'done' conosce immediatamente tutti gli stati possibili: nessuna supposizione e nessuna stringa magica sparsa nel codice.

type Status = 'idle' | 'loading' | 'done';

function render(s: Status): string {
  return 'State is: ' + s;
}

console.log(render('loading'));

Combinare letterali con altri tipi

Può combinare i tipi letterali con tipi più generali in un'unione. Un modello comune è 'auto' | number, che indica 'auto' oppure un numero qualsiasi.

type Width = 'auto' | number;

function setWidth(w: Width): void {
  console.log('Width:', w);
}

setWidth('auto');
setWidth(320);

Letterali come costanti denominate

I tipi letterali si combinano perfettamente con le costanti denominate. Definisca il tipo una sola volta, lo riutilizzi ovunque e faccia il refactoring in sicurezza. Il compilatore mantiene coerente ogni utilizzo.

type Theme = 'light' | 'dark';

const DEFAULT_THEME: Theme = 'dark';

function applyTheme(t: Theme): void {
  console.log('Applying', t, 'theme');
}

applyTheme(DEFAULT_THEME);

Verifica rapida

Verifichi la sua comprensione dei tipi letterali.

Riepilogo: tipi letterali

Ha imparato che:

  • I tipi letterali rappresentano un unico valore preciso, ad esempio 'north' o 6.
  • La combinazione di letterali con | crea un' unione finita di valori consentiti.
  • Funzionano con stringhe, numeri e booleani e possono essere combinati con tipi più generali come 'auto' | number.
  • Usati come parametri di funzione, offrono il completamento automatico e rifiutano gli input non validi in fase di compilazione.

Ora analizziamo come TypeScript sceglie tra tipi letterali e tipi ampliati.

type Direction = 'north' | 'south' | 'east' | 'west';
type Dice = 1 | 2 | 3 | 4 | 5 | 6;

function describe(d: Direction, n: Dice): string {
  return 'Go ' + d + ' ' + n + ' steps';
}

console.log(describe('north', 3));

Domande Frequenti

La lezione «Tipi literal stringa e numerici» è gratuita?

Sì — il testo completo di «Tipi literal stringa e numerici» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso TypeScript Academy, passa a CoddyKit PRO. Il corso TypeScript Academy include 4 lezioni in totale.

Cosa imparerò in «Tipi literal stringa e numerici»?

Limiti i valori a stringhe e numeri esatti utilizzando i tipi literal. Eserciti TypeScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare TypeScript Academy?

Non è richiesta alcuna esperienza precedente. TypeScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «Tipi literal stringa e numerici»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione TypeScript Academy?

Sì. Ogni lezione TypeScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Tipi literal stringa e numerici
  2. Literal booleani e inferenza dei literal
  3. Asserzioni const con as const
  4. Combinare i literal in union
← Torna a TypeScript Academy