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()ouqueryAll()pour retrouver unDebugElementpar sélecteur CSS, par exemplefixture.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évalued'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 }ouuseValue: { ... }. Isole le composant testé du comportement réel du service.- provideRouter([])
Fournisseur de routeur minimal, utilisable dans les
providersdeTestBedpour qu'un composant qui dépend du routeur (injecteRouterou utiliserouterLink) puisse être instancié en test, sans définir de vraies routes.- ActivatedRoute simulée
Remplacement de
ActivatedRoutepar un objet fourni viauseValuedans lesprovidersde test, exposant les paramètres de route attendus (paramMap,snapshot), pour tester un composant routé sans navigation réelle.
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.