0Pricing
TypeScript Academy · Leçon

Tester les types avec expectTypeOf et tsd

Vérifiez la correction des types en parallèle du comportement à l’exécution

Tester les types avec expectTypeOf et tsd est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 4 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

Tester les types eux-mêmes — et pas seulement le comportement à l’exécution — garantit que vos utilitaires TypeScript et vos types génériques fonctionnent correctement.

Pourquoi tester les types

Les utilitaires génériques et les types conditionnels peuvent contenir des bogues qui n’affectent que certains arguments de type. Les tests de types les détectent.

expectTypeOf de Vitest

Vitest fournit expectTypeOf pour les assertions de types lors de la compilation.
import { expectTypeOf } from 'vitest';
expectTypeOf(42).toBeNumber();
expectTypeOf('hello').toBeString();

Assertion des types de retour

Vérifiez le type de retour d’une fonction.
import { identity } from '../src/utils';
expectTypeOf(identity(42)).toEqualTypeOf<number>();
expectTypeOf(identity('hi')).toEqualTypeOf<string>();

Bibliothèque tsd

tsd est un outil CLI de test de types pour les fichiers de déclaration TypeScript.
npm install --save-dev tsd

Assertions tsd

Écrivez des fichiers .test-d.ts avec des assertions tsd.
import { expectType, expectError } from 'tsd';
import { add } from '../src';
expectType<number>(add(1, 2));
expectError(add('a', 'b'));

Bibliothèque expect-type

La bibliothèque expect-type fournit des assertions de types compatibles avec Jest.
import { expectTypeOf } from 'expect-type';
expectTypeOf<User>().toHaveProperty('name').toBeString();

Tester les types conditionnels

Vérifiez que les types conditionnels produisent la sortie correcte pour différentes entrées.
type IsArray<T> = T extends any[] ? true : false;
expectTypeOf<IsArray<string[]>>().toEqualTypeOf<true>();
expectTypeOf<IsArray<string>>().toEqualTypeOf<false>();

Tester les types mappés

Vérifiez que les utilitaires de types mappés produisent les formes correctes.
type Mutable = { -readonly [K in keyof ReadonlyUser]: ReadonlyUser[K] };
expectTypeOf<Mutable['name']>().toBeString();
expectTypeOf<Mutable>().not.toMatchTypeOf<Readonly<Mutable>>();

Exécution de tsd dans l’intégration continue

Ajoutez tsd à votre pipeline d’intégration continue pour détecter les régressions de types.
// package.json
{ "scripts": { "test:types": "tsd" } }

Tests de types et tests à l’exécution

Les tests de types s’exécutent lors de la compilation, sans coût à l’exécution. Les tests à l’exécution valident le comportement. Les deux sont nécessaires.

Vérification rapide

Que vérifie `expectTypeOf(add(1, 2)).toEqualTypeOf()` ?

Récapitulatif

Test de types avec expectTypeOf et tsd : vous maîtrisez désormais les concepts et les modèles essentiels.

Questions Fréquemment Posées

La leçon « Tester les types avec expectTypeOf et tsd » est-elle gratuite ?

Oui — le texte complet de « Tester les types avec expectTypeOf et tsd » 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 « Tester les types avec expectTypeOf et tsd » ?

Vérifiez la correction des types en parallèle du comportement à l’exécution 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 4 sur 4.

Combien de temps prend la leçon « Tester les types avec expectTypeOf et tsd » ?

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. Configurer Jest pour TypeScript avec ts-jest
  2. Écrire des tests unitaires sûrs du point de vue des types
  3. Simuler des modules et des fonctions en TypeScript
  4. Tester les types avec expectTypeOf et tsd
← Retour à TypeScript Academy