Emails Troubleshooting

​

mail.inbox() Throws Because No Client Is Configured

• the runner creates the client
• the runner configures it before flow execution

​

waitForMessage(...) Returns An Older Message

• whether the flow should pass after: new Date()
• whether the same inbox is being reused across multiple steps or retries

​

No Message Arrives Before Timeout

• the product under test actually sent the email
• the address being used is allowed for the workspace
• the timeout is long enough for the expected delivery path

​

Old emails are matched by waitForMessage

const after = new Date();
await page.getByRole("button", { name: "Send code" }).click();

const message = await inbox.waitForMessage({ after });