Primeros pasos

Inicio rápido

Captura un correo de registro y sigue su enlace de verificación desde una prueba.

Esta guía captura un correo de registro y sigue su enlace de verificación desde una prueba de navegador.

Iniciar InboxTap

Ejecuta el servidor en una terminal aparte:

npx inboxtap

Los valores por defecto son SMTP localhost:1025, HTTP http://localhost:8025 y el dominio de destinatarios local.test.

Crear un buzón aislado

Crea una dirección para la prueba actual. El cliente descubre el dominio del servidor y añade un sufijo aleatorio al alias, de modo que las pruebas en paralelo no leen los mensajes de otras.

import { InboxTapClient } from "inboxtap/client";

const inboxTap = new InboxTapClient();
const inbox = await inboxTap.createInbox({ alias: "signup" });

Una dirección tiene la forma signup-f2a737d0-d1e@local.test. No hace falta registrarla en el servidor antes de usarla.

Iniciar el envío del correo

Pasa inbox.address por el mismo flujo de aplicación que sigue un usuario:

await page.getByLabel("Email").fill(inbox.address);
await page.getByRole("button", { name: "Create account" }).click();

Tu aplicación debe estar configurada para entregar el correo SMTP a InboxTap.

Esperar el resultado

Espera un enlace que coincida y continúa el flujo del navegador:

const verificationUrl = await inbox.waitForLink({
  subject: /verify your email/i,
  contains: "/verify",
});

await page.goto(verificationUrl);

Las funciones auxiliares de extracción devuelven cadenas. Usa waitForMessage() cuando la aserción necesite el correo capturado completo, o messages() para inspeccionar todo lo que ya ha recibido la dirección.

const code = await inbox.waitForCode({ subject: /security code/i });
const key = await inbox.waitForMatch({ pattern: /api_key=([A-Za-z0-9_-]+)/ });

await inbox.clear();