Cypress

Un test Cypress qui s’inscrit avec une nouvelle adresse et ouvre le lien de vérification de l’e-mail, à l’aide du package proxymail-qa dans des tâches Cypress.

1. Installer le package

   Ajoutez proxymail-qa au projet.

   npmpnpmyarnbun

   npm install --save-dev proxymail-qa

   pnpm add -D proxymail-qa

   yarn add -D proxymail-qa

   bun add -d proxymail-qa

2. Enregistrer les tâches

   Cypress exécute les tâches dans Node, donc enregistrez-les dans la configuration. La clé d’API provient de PROXYMAIL_QA_API_KEY dans l’environnement où tourne Cypress.

   cypress.config.ts

   import { defineConfig } from 'cypress';
   import { ProxyMailQA } from 'proxymail-qa';
   
   export default defineConfig({
     e2e: {
       setupNodeEvents(on) {
         const qa = new ProxyMailQA(); // reads PROXYMAIL_QA_API_KEY
         on('task', {
           createAddress: () => qa.createAddress({ persona: true }),
           waitForLink: ({ address, since }: { address: string; since: string }) => qa.waitForLink(address, { type: 'verify', since }),
           deleteAddress: (address: string) => qa.deleteAddress(address).then(() => null),
         });
       },
     },
   });

3. S’inscrire et ouvrir le lien

   Inscrivez-vous avec l’adresse, puis ouvrez le lien de l’e-mail.

   Le délai de la tâche est de 35 secondes, car une attente peut durer jusqu’à 30. Pour un code plutôt qu’un lien, ajoutez une tâche qui appelle qa.waitForCode(address, { since }) et saisissez son value dans le formulaire.

   cypress/e2e/signup.cy.js

   it('verifies the email', () => {
     cy.task('createAddress').then(({ address }) => {
       const since = new Date().toISOString();
       cy.visit('/signup');
       cy.get('[name=email]').type(address);
       cy.contains('Sign up').click();
       cy.task('waitForLink', { address, since }, { timeout: 35000 }).then(({ value }) => cy.visit(value));
       cy.task('deleteAddress', address);
     });
   });

Si rien n’arrive, l’erreur indique pourquoi, dans la mesure où Proxy Mail QA peut le savoir, par exemple que le fournisseur d’e-mail de votre app n’envoie qu’aux adresses vérifiées. Pour l’exécution dans CI, voir Exécuter dans CI. Vous préférez du HTTP simple depuis la spec avec cy.request ? Chaque appel figure dans le guide REST API.