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
HttpTestingControllerqui 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 ensuiteflush()ouerror().- 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 unafterEach().- provideHttpClientTesting()
Fournisseur qui remplace le backend HTTP réel par un backend de test dans
TestBed. Doit être déclaré aprèsprovideHttpClient(...)dans le tableauproviders, sous peine de compromettre le test.- fakeAsync
Utilitaire historique de test Angular (
@angular/core/testing) qui permettait d'avancer le temps virtuellement avectick(). 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(), puisawait vi.runAllTimersAsync()).
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.