Aller au contenu
Facteur
/ Playwright

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.

Le test en entier

Rien n'est coupé

C'est le fichier complet, et il n'importe que Playwright.

inscription.spec.ts TypeScript
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

Pourquoi ce test tient en trente lignes

01

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.

02

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.

03

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.

Le plugin Playwright

É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.