0Pricing
TypeScript Academy · Lezione

Restringimento con instanceof e in

Restringa i tipi delle istanze di classe e delle strutture degli oggetti.

Restringimento con instanceof e in è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 2 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.

Benvenuto

`instanceof` restringe le istanze delle classi e `in` restringe i tipi oggetto in base alla presenza delle proprietà. Entrambi sono essenziali per lavorare con unioni complesse.

Restringimento con instanceof

Utilizzi `instanceof` per verificare se un valore è un'istanza di una classe. TypeScript restringe il tipo a quella classe.
function handle(err: Error | string) {
  if (err instanceof Error) {
    console.log(err.message); // err: Error
  } else {
    console.log(err); // err: string
  }
}

instanceof con classi personalizzate

instanceof funziona anche con le classi definite da Lei.
class Dog { bark() { return 'Woof'; } }
class Cat { meow() { return 'Meow'; } }
function speak(pet: Dog | Cat) {
  if (pet instanceof Dog) pet.bark();
  else pet.meow();
}

instanceof non funziona con le interfacce

Le interfacce vengono rimosse a runtime. Non può utilizzare instanceof con un'interfaccia, ma solo con le classi.

L'operatore in

Utilizzi `in` per verificare se una proprietà esiste in un oggetto. TypeScript restringe l'unione ai membri che possiedono quella proprietà.
type Fish = { swim(): void };
type Bird = { fly(): void };
function move(animal: Fish | Bird) {
  if ('swim' in animal) animal.swim();
  else animal.fly();
}

Restringimento con in e proprietà facoltative

`in` restringe il tipo anche per le proprietà facoltative: lo restringe ai membri dell'unione in cui la proprietà PUÒ esistere.
type A = { x?: number };
type B = { y: number };
function process(v: A | B) {
  if ('x' in v) {
    // v: A (has optional x)
  }
}

Combinazione di instanceof e in

Può combinare entrambe le tecniche di restringimento per discriminare tipi complessi.
function describe(v: Error | { message: string }) {
  if (v instanceof Error) console.log('Error:', v.stack);
  else if ('message' in v) console.log('Object:', v.message);
}

in per le unioni discriminate

Quando i membri di un'unione non hanno un discriminante, i controlli `in` possono svolgere la stessa funzione di restringimento.
type Square = { side: number };
type Circle = { radius: number };
function area(s: Square | Circle): number {
  return 'side' in s ? s.side ** 2 : Math.PI * s.radius ** 2;
}

instanceof nei blocchi catch

Utilizzi instanceof nei blocchi catch per distinguere i tipi di errore.
try {
  await fetchData();
} catch (err) {
  if (err instanceof NetworkError) { /* retry */ }
  else if (err instanceof AuthError) { /* redirect */ }
  else throw err;
}

Controllo Object.prototype rispetto a in

Sia `key in obj` sia `Object.prototype.hasOwnProperty.call(obj, key)` verificano l'esistenza di una proprietà, ma `in` considera anche le proprietà ereditate.

Priorità del restringimento

Quando si applicano più controlli di restringimento, TypeScript interseca i tipi ristretti, ottenendo il tipo più specifico possibile.

Verifica rapida

Perché non può utilizzare `instanceof` per restringere il tipo di un'interfaccia in TypeScript?

Riepilogo

`instanceof` restringe a runtime le istanze delle classi. `in` restringe le unioni di oggetti in base all'esistenza delle proprietà. Utilizzi entrambi quando lavora con gerarchie di classi e unioni di oggetti strutturali.

Domande Frequenti

La lezione «Restringimento con instanceof e in» è gratuita?

Sì — il testo completo di «Restringimento con instanceof e in» è 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 «Restringimento con instanceof e in»?

Restringa i tipi delle istanze di classe e delle strutture degli oggetti. 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 2 di 4.

Quanto tempo richiede la lezione «Restringimento con instanceof e in»?

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. Restringimento con typeof e truthiness
  2. Restringimento con instanceof e in
  3. Funzioni predicato per i type guard definiti dall'utente
  4. Verifica dell'esaustività con never
← Torna a TypeScript Academy