ddd-ts-kit/test-assertion-present
Identifiant d'architecture : test/assertion-present (ajouté par ce plugin). Sévérité par défaut : error dans recommended, error dans strict.
S'applique à : chaque fichier de test du projet (*.spec.ts, *.test.ts, le test/ d'un contexte).
Pourquoi
Section intitulée « Pourquoi »Un test qui ne vérifie rien passe quoi que fasse le code, et fait monter le taux de couverture sans rien prouver : c'est le trou que test/coverage-governed ne peut pas voir. Le kit vérifie des résultats : l'état d'un fake, les faits enregistrés, le refus par son code, la réponse d'une route.
- un
itou untestdont le corps ne contient aucun appel àexpect, à une fonction nomméeexpect...ouassert...(expectRefusal,expectProblem,expectStatus,expectSpanTree, un helper du projet), ni au résultat d'un scénario de@ddd-ts-kit/testing(thenEvents,thenEventNames,thenError,thenState,thenNoEvent) - un
itou untestavec un titre et sans corps, que Vitest compte comme un todo et que Jest refuse
Incorrect :
it('issues the invoice', async () => { await application.commandBus.execute(new IssueInvoiceCommand(holder, 'customer-1'));});
it('refuses a second payment');Correct :
it('issues the invoice and answers its identifier', async () => { const id = await application.commandBus.execute(new IssueInvoiceCommand(holder, 'customer-1'));
expect(await invoiceRepository.findById(id)).toBeDefined();});
it.todo('refuses a second payment');Le corps est lu en entier, scénario enveloppé par pending(...) compris, de sorte qu'un scénario d'acceptation qui attend son code est jugé comme les autres. Un helper qui vérifie pour plusieurs tests se nomme expect... ou assert... : la règle le voit alors, et le lecteur aussi.
Aucune.
rules."test/assertion-present" à off dans ddd-ts-kit.config.json désactive la règle, et // ddd-ts-kit-disable-next-line test/assertion-present -- <reason> désactive une ligne, exactement comme pour ddd-ts-kit check.
- La règle voit qu'une vérification est faite, pas qu'elle porte sur le résultat :
expect(true).toBe(true)passe. La revue lit ce qui est vérifié. - Un
.then(...)sur une promesse n'est pas le résultat d'un scénario.
Avec le checker de la CLI
Section intitulée « Avec le checker de la CLI »Nouveau avec ce plugin : le checker de la CLI n'a pas d'équivalent, car lire un test demande un arbre syntaxique.