Formations — 1 037 leçons en français

Accueil › Angular › Tester services et appels HTTP

Tester services et appels HTTP

Tester une application Angularintermediaire

Un service à signaux, sans dépendance HTTP, se teste souvent sans TestBed : c'est une classe normale, instanciable directement.

const service = new PanierService();
service.ajouter({ produit: 'Clavier', prix: 49, quantite: 1 });
expect(service.total()).toBe(49);

TestBed redevient nécessaire dès que le service utilise inject() ou dépend d'autres services fournis par injection — dont HttpClient. Pour tester un service qui fait des appels HTTP, on remplace le vrai réseau par un contrôleur de test :

TestBed.configureTestingModule({
  providers: [provideHttpClient(), provideHttpClientTesting()],
});

const httpTesting = TestBed.inject(HttpTestingController);
const service = TestBed.inject(ProduitService);

service.chargerProduit(42).subscribe();

const req = httpTesting.expectOne('/api/produits/42');
expect(req.request.method).toBe('GET');
req.flush({ id: 42, nom: 'Clavier' });

httpTesting.verify();

expectOne() capture la requête au lieu de l'envoyer, flush() simule la réponse du serveur, verify() (souvent dans un afterEach) s'assure qu'aucune requête n'a été oubliée. Important : provideHttpClient(...) doit toujours précéder provideHttpClientTesting() dans les providers.

Pour le code asynchrone en général, les promesses et observables se testent normalement (await, firstValueFrom, ou assertions dans le subscribe). fakeAsync/tick() — l'ancien outil pour avancer le temps virtuellement — n'est plus recommandé et ne fonctionne pas avec Vitest ; Vitest fournit ses propres minuteurs simulés.

Les termes à connaître

HttpTestingController

Service injectable (provideHttpClientTesting()) qui capture les requêtes émises pendant un test au lieu de les envoyer sur le réseau. Permet de faire des assertions sur ces requêtes puis de simuler leur réponse.

expectOne()

Méthode de HttpTestingController qui vérifie qu'exactement une requête correspond aux critères donnés (URL, méthode, prédicat), et échoue sinon. Renvoie l'objet requête capturée, sur lequel on appelle ensuite flush() ou error().

flush()

Simule la réponse du serveur pour une requête capturée : req.flush(donnees) pour un succès, req.flush(message, { status, statusText }) pour une erreur HTTP avec un code précis.

verify()

Vérifie qu'aucune requête inattendue n'a été faite pendant le test (aucune requête « oubliée », non vérifiée par un expectOne/match). S'appelle généralement dans un afterEach().

provideHttpClientTesting()

Fournisseur qui remplace le backend HTTP réel par un backend de test dans TestBed. Doit être déclaré après provideHttpClient(...) dans le tableau providers, sous peine de compromettre le test.

fakeAsync

Utilitaire historique de test Angular (@angular/core/testing) qui permettait d'avancer le temps virtuellement avec tick(). Non recommandé et incompatible avec le runner Vitest — à réserver, si nécessaire, à un projet resté sur Karma.

vi.useFakeTimers()

Fonctionnalité de minuteurs simulés fournie par Vitest, alternative à fakeAsync/tick() pour contrôler le temps dans un test (vi.useFakeTimers(), puis await vi.runAllTimersAsync()).

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.