Votre test attend un e-mail, il ne dort pas
Un parcours d'inscription se termine dans une boîte aux lettres. Sans boîte que le test puisse lire, il ne reste que deux options : simuler l'envoi, ce qui ne prouve rien de la partie la plus fragile, ou boucler avec un délai fixe. Voici la troisième.
Rien n'est coupé
C'est le fichier complet, et il n'importe que Playwright.
import { expect, test } from '@playwright/test';
const INBOX = 'j3k9x2mq';
// Reste ouverte jusqu'à l'arrivée du message, trente secondes au plus.
async function attendre(sentTo: string) {
const search = new URLSearchParams({ inbox: INBOX, sentTo, wait: '30000' });
const response = await fetch('https://api.facteur.eu/v1/messages?' + search, {
headers: { authorization: 'Bearer ' + process.env.FACTEUR_API_KEY },
});
const { messages } = await response.json();
if (!messages[0]) throw new Error('Rien n\'est arrivé pour ' + sentTo);
return messages[0];
}
test('le lien de vérification active le compte', async ({ page }) => {
const tag = 'run-' + Date.now();
// Lancée avant le clic : elle répond dès que l'e-mail arrive.
const arrive = attendre('inscription+' + tag);
await page.goto('/inscription');
await page.getByLabel('Email').fill('inscription+' + tag + '@' + INBOX + '.inbox.facteur.eu');
await page.getByRole('button', { name: 'Créer mon compte' }).click();
const message = await arrive;
// Le status avant tout champ tiré du corps du message.
expect(message.status).toBe('parsed');
await page.goto(message.links[0]);
await expect(page.getByText('Compte vérifié')).toBeVisible();
});
- La requête part avant le clic
- Elle reste ouverte et répond à l'instant où l'e-mail arrive, pas à l'échéance. Lancée après le clic, elle courrait après un message peut-être déjà traité.
- Chaque test a son adresse
- Tout ce qui suit le « + » vous appartient et arrive quand même. Deux tests qui tournent en même temps ne se volent donc pas leurs e-mails, sans rien créer au préalable.
- Le code est déjà extrait
- Le message arrive avec son code à usage unique dans le champ otp, et ses liens dans links. Vous ne réécrivez pas l'expression régulière qui traîne dans toutes les suites de tests.
- On lit status avant tout le reste
- Un e-mail accepté existe un instant avant d'être lu : il n'a alors ni sujet, ni code. Ce champ sépare « pas de code dans ce message » de « le code n'est pas encore extrait ».
Pourquoi ce test tient en trente lignes
L'attente se fait chez Facteur
Vous fixez un délai maximum, cinq minutes au plus, la requête reste ouverte, et elle répond dès l'arrivée. Votre test ne contient aucune boucle de relance, et rien à régler quand l'intégration continue ralentit.
L'extraction se fait à la réception
Codes à usage unique et liens sont sortis du corps du message au moment où il arrive. Votre test lit un champ au lieu de découper du HTML.
Les adresses sont illimitées
Toute adresse qui finit par le domaine de votre inbox arrive, sans appel d'API pour la créer. C'est ce qui rend une adresse par test gratuite.
Écrit, pas encore publié
playwright-facteur calcule une adresse par test, rejoue ses assertions comme Playwright et attache le message reçu au rapport. Il n'est pas encore publié sur npm. Le test ci-dessus ne l'utilise pas, et continuera de marcher le jour où il le sera : le plugin fera gagner du confort, pas des capacités.
Écrivez ce test aujourd'hui
L'offre gratuite ouvre une inbox, sans carte bancaire. Le temps de créer un compte, vous avez l'adresse à mettre dans le test ci-dessus.