Formations — 1 037 leçons en français

Accueil › Angular › Vitest et TestBed

Vitest et TestBed

Tester une application Angularintermediaire

Depuis Angular 21, un projet créé avec ng new embarque Vitest comme runner de tests par défaut (avec jsdom pour simuler un DOM sans navigateur). ng test construit l'application en mode watch et lance Vitest. Karma reste pleinement supporté pour les projets existants ou pour qui préfère exécuter les tests dans un vrai navigateur, mais ce n'est plus le choix par défaut.

Un fichier de test (produit-card.spec.ts) suit toujours la même structure, indépendamment du runner :

import { TestBed } from '@angular/core/testing';
import { ProduitCard } from './produit-card';

describe('ProduitCard', () => {
  it('devrait se créer', () => {
    TestBed.configureTestingModule({});
    const fixture = TestBed.createComponent(ProduitCard);
    expect(fixture.componentInstance).toBeTruthy();
  });
});

TestBed.configureTestingModule({ imports, providers }) déclare l'environnement du test (composants à importer, services à fournir ou remplacer). TestBed.createComponent() instancie le composant testé et renvoie un ComponentFixture : le harnais qui donne accès à l'instance, à l'élément DOM et aux méthodes de détection de changements. Attention : createComponent() fige la configuration de TestBed — plus aucun appel à configureTestingModule() n'est possible après.

En mode zoneless (par défaut en v21), rien ne déclenche automatiquement un rendu après la création du composant : await fixture.whenStable() attend que l'application se stabilise, fixture.detectChanges() force un cycle de détection de changements immédiat.

Les termes à connaître

Vitest

Runner de tests installé et configuré par défaut pour tout nouveau projet Angular 21 créé avec ng new (avec jsdom pour simuler le DOM). Il exécute les tests dans Node.js plutôt que dans un vrai navigateur, ce qui le rend nettement plus rapide que Karma.

TestBed

Module de test d'Angular : on lui déclare un environnement (imports, providers) avec TestBed.configureTestingModule(), puis on l'utilise pour créer des composants (createComponent()) ou récupérer des services (inject()).

ComponentFixture

Objet renvoyé par TestBed.createComponent(). C'est le harnais de test d'un composant : il expose l'instance (componentInstance), l'élément DOM (nativeElement), le DebugElement, et les méthodes pour piloter la détection de changements.

fixture.detectChanges()

Déclenche manuellement un cycle de détection de changements sur le composant testé : les liaisons de template ({{ }}, [input]) sont mises à jour dans le DOM à cet instant précis.

fixture.whenStable()

Renvoie une promesse résolue quand l'application est stabilisée (plus de tâches asynchrones en attente, rendu à jour). En mode zoneless, c'est la façon recommandée d'attendre le rendu initial avant les assertions.

Karma

Ancien runner de tests d'Angular, basé sur Jasmine et exécuté dans un vrai navigateur. Toujours pleinement supporté en Angular 21, mais n'est plus le choix par défaut d'un nouveau projet.

.spec.ts

Suffixe conventionnel d'un fichier de test Angular (panier.spec.ts pour panier.ts). Vitest détecte les fichiers de test via le motif **/*.spec.ts (et **/*.test.ts) configuré dans angular.json.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.