0Pricing
TypeScript Academy · Leçon

Rétrécissement avec instanceof et in

Affinez les instances de classes et les structures d’objets

Rétrécissement avec instanceof et in est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage TypeScript Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours TypeScript Academy comprend 4 leçons au total.

Bienvenue

`instanceof` affine les instances de classes, tandis que `in` affine les types objet selon la présence d’une propriété. Ces deux opérateurs sont essentiels pour travailler avec des unions complexes.

Affinage avec instanceof

Utilisez `instanceof` pour vérifier qu’une valeur est une instance d’une classe. TypeScript affine alors le type vers cette classe.
function handle(err: Error | string) {
  if (err instanceof Error) {
    console.log(err.message); // err: Error
  } else {
    console.log(err); // err: string
  }
}

instanceof avec des classes personnalisées

instanceof fonctionne également avec vos propres classes.
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 ne fonctionne pas avec les interfaces

Les interfaces sont supprimées lors de l’exécution. Vous ne pouvez pas utiliser instanceof avec une interface, uniquement avec des classes.

L’opérateur in

Utilisez `in` pour vérifier qu’une propriété existe sur un objet. TypeScript affine l’union vers les membres qui possèdent cette propriété.
type Fish = { swim(): void };
type Bird = { fly(): void };
function move(animal: Fish | Bird) {
  if ('swim' in animal) animal.swim();
  else animal.fly();
}

Affinage avec in et les propriétés facultatives

`in` affine également les propriétés facultatives : il conserve les membres de l’union pour lesquels la propriété PEUT exister.
type A = { x?: number };
type B = { y: number };
function process(v: A | B) {
  if ('x' in v) {
    // v: A (has optional x)
  }
}

Combinaison de instanceof et de in

Vous pouvez combiner ces deux techniques d’affinage pour discriminer des types complexes.
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);
}

Utiliser in pour les unions discriminées

Lorsque les membres d’une union n’ont pas de discriminant, les vérifications avec `in` peuvent servir au même objectif d’affinage.
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 dans les blocs catch

Utilisez instanceof dans les blocs catch pour distinguer les types d’erreur.
try {
  await fetchData();
} catch (err) {
  if (err instanceof NetworkError) { /* retry */ }
  else if (err instanceof AuthError) { /* redirect */ }
  else throw err;
}

Vérification avec Object.prototype par rapport à in

`key in obj` et `Object.prototype.hasOwnProperty.call(obj, key)` vérifient tous deux l’existence d’une propriété, mais `in` prend également en compte les propriétés héritées.

Priorité de l’affinage

Lorsque plusieurs vérifications d’affinage s’appliquent, TypeScript intersecte les types affinés afin d’obtenir le type le plus précis possible.

Vérification rapide

Pourquoi ne pouvez-vous pas utiliser `instanceof` pour affiner un type d’interface dans TypeScript ?

Récapitulatif

`instanceof` affine les instances de classes lors de l’exécution. `in` affine les unions d’objets selon l’existence d’une propriété. Utilisez les deux pour travailler avec des hiérarchies de classes et des unions structurelles d’objets.

Questions Fréquemment Posées

La leçon « Rétrécissement avec instanceof et in » est-elle gratuite ?

Oui — le texte complet de « Rétrécissement avec instanceof et in » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours TypeScript Academy, passe à CoddyKit PRO. Le cours TypeScript Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Rétrécissement avec instanceof et in » ?

Affinez les instances de classes et les structures d’objets Tu pratiques TypeScript Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer TypeScript Academy ?

Aucune expérience préalable n'est requise. TypeScript Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.

Combien de temps prend la leçon « Rétrécissement avec instanceof et in » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon TypeScript Academy ?

Oui. Chaque leçon TypeScript Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Rétrécissement avec typeof et la véracité
  2. Rétrécissement avec instanceof et in
  3. Fonctions de garde de types définies par l’utilisateur
  4. Vérification de l’exhaustivité avec never
← Retour à TypeScript Academy