0Pricing
TypeScript Academy · Leçon

Typage des tests et simulations ; expectTypeOf

Utilisez expectTypeOf pour les vérifications statiques et des simulations sûres du point de vue des types dans Vitest/Jest afin d’éviter les tests fragiles.

Typage des tests et simulations ; expectTypeOf est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 3. 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 3 leçons au total.

Introduction

Objectif : vérifiez les types avec expectTypeOf et écrivez des simulations sûres du point de vue des types afin que les refactorisations ne cassent pas silencieusement les tests.

Bases de expectTypeOf

expectTypeOf vérifie les types à la compilation dans Vitest ; il n’a aucun coût à l’exécution, mais détecte tôt les incompatibilités.

// Vitest provides expectTypeOf
import { expectTypeOf } from "vitest";

function fullName(first: string, last: string) {
  return `${first} ${last}`
}

// static checks (compile-time)
expectTypeOf(fullName).toBeFunction()
expectTypeOf(fullName("Ada","Lovelace")).toBeString()

Assertions avancées

Motifs utiles : résoudre les types de retour avec Awaited<ReturnType<...>>, et comparer les littéraux et les unions.

import { expectTypeOf } from "vitest";

interface User { id: number; name: string }
function getUser(): Promise<User> { return Promise.resolve({ id:1, name:"A" }) }

// unwrap Promise
type Resolved = Awaited<ReturnType<typeof getUser>>
expectTypeOf<Resolved>().toMatchTypeOf<User>()

// literal + union
const status = "ok" as const
expectTypeOf(status).toEqualTypeOf<"ok">()

Simulations Vitest

Donnez le type correct à la simulation en fournissant une signature à vi.fn ; les arguments incorrects seront détectés lors de la compilation.

import { vi, describe, it, expect } from "vitest";

function fetchUser(id: number): Promise<string> {
  return Promise.resolve(`user-${id}`)
}

// typed mock
const mockFetch: ReturnType<typeof vi.fn<[(id: number), Promise<string>]>> = vi.fn(async (id: number) => `user-${id}`)

it("uses typed mock", async () => {
  const name = await mockFetch(5)
  expect(name).toBe("user-5")
  // mockFetch("x") // TS error: id must be number
})

Simulations Jest

Dans Jest, imposez la signature d’appel en écrivant jest.fn<Signature>(); désambiguïsez le type de la simulation avec MockedFunction.

import { jest } from "@jest/globals";

function times(a: number, b: number) { return a * b }

const mul = jest.fn<(a:number,b:number)=>number>((a,b)=>a*b)

mul(2,3) // ok
// mul("2",3) // TS error

// MockedFunction utility
type MulMock = jest.MockedFunction<typeof mul>
const _check: MulMock = mul

Conseils

Séparez la validation des valeurs (à l’exécution) de la validation des types (à la compilation) ; ce sont deux couches différentes.

// value assertions
import { expect } from "vitest";
expect(2 + 3).toBe(5)

// type assertions (compile-time)
import { expectTypeOf } from "vitest";
expectTypeOf(2 + 3).toBeNumber()

// don't confuse with runtime validators like zod

Question

Vérification rapide : que vérifie expectTypeOf pendant l’exécution d’un test ?

Récapitulatif

Récapitulatif : expectTypeOf — garantie de type à la compilation ; vi.fn/jest.fn — simulations sûres du point de vue des types avec une signature.

Questions Fréquemment Posées

La leçon « Typage des tests et simulations ; expectTypeOf » est-elle gratuite ?

Oui — le texte complet de « Typage des tests et simulations ; expectTypeOf » 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 3 leçons au total.

Qu'est-ce que j'apprendrai dans « Typage des tests et simulations ; expectTypeOf » ?

Utilisez expectTypeOf pour les vérifications statiques et des simulations sûres du point de vue des types dans Vitest/Jest afin d’éviter les tests fragiles. 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 3.

Combien de temps prend la leçon « Typage des tests et simulations ; expectTypeOf » ?

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. Configuration de Vitest/Jest pour TS
  2. Typage des tests et simulations ; expectTypeOf
  3. Aperçu du typage E2E (Playwright/Cypress)
← Retour à TypeScript Academy