Formations — 1 037 leçons en français

Accueil › Angular › Tester un composant

Tester un composant

Tester une application Angularintermediaire

Tester un composant, c'est le créer via TestBed, lui donner des entrées, puis vérifier ce qu'il affiche ou ce qu'il émet. Trois accès au rendu : fixture.nativeElement (élément DOM natif, pratique pour querySelector), fixture.debugElement (abstraction DebugElement, indépendante de la plateforme, avec By.css()), et l'instance du composant elle-même.

const fixture = TestBed.createComponent(ProduitCard);
fixture.componentRef.setInput('nom', 'Clavier mécanique');
await fixture.whenStable();

const titre = fixture.nativeElement.querySelector('h3');
expect(titre.textContent).toContain('Clavier mécanique');

Pour une entrée signal (input()) ou un @Input() classique, on ne les affecte jamais directement sur l'instance : fixture.componentRef.setInput('nom', valeur) simule fidèlement ce qu'un composant parent ferait. Pour une sortie (output()), on s'y abonne comme le ferait un parent : component.selectionne.subscribe(v => …).

Simuler un clic est direct (element.click() ou debugElement.triggerEventHandler('click')), mais simuler une saisie demande deux étapes : modifier value, puis déclencher l'événement (dispatchEvent(new Event('input'))), car Angular réagit à l'événement, pas à la propriété.

Quand un composant dépend d'un service ou du routeur, on isole le test avec un double de test (useClass/useValue dans providers) plutôt que d'utiliser les vraies dépendances.

Les termes à connaître

DebugElement

Enveloppe d'un nœud du DOM rendue par Angular, accessible via fixture.debugElement. Contrairement à nativeElement, elle fonctionne de façon identique quelle que soit la plateforme (navigateur, serveur), et donne accès à l'injecteur du nœud.

By.css()

Sélecteur utilisé avec debugElement.query() ou queryAll() pour retrouver un DebugElement par sélecteur CSS, par exemple fixture.debugElement.query(By.css('button.primaire')).

fixture.componentRef.setInput()

Façon recommandée de simuler la valeur qu'un composant parent donnerait à une entrée (input() ou @Input()) dans un test. Contrairement à une affectation directe sur l'instance, elle passe par le vrai mécanisme de liaison d'entrée d'Angular.

dispatchEvent

Méthode DOM permettant de déclencher manuellement un événement (input, click, submit) dans un test. Nécessaire après avoir modifié la propriété value d'un champ, car Angular ne surveille pas cette propriété directement : il écoute l'événement.

Double de test

Objet de substitution fourni à la place d'une vraie dépendance dans TestBed.configureTestingModule({ providers: [...] }), généralement via { provide: MonService, useClass: MonServiceStub } ou useValue: { ... }. Isole le composant testé du comportement réel du service.

provideRouter([])

Fournisseur de routeur minimal, utilisable dans les providers de TestBed pour qu'un composant qui dépend du routeur (injecte Router ou utilise routerLink) puisse être instancié en test, sans définir de vraies routes.

ActivatedRoute simulée

Remplacement de ActivatedRoute par un objet fourni via useValue dans les providers de test, exposant les paramètres de route attendus (paramMap, snapshot), pour tester un composant routé sans navigation réelle.

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.