Skip to content
MailSlurp logo

Test Clerk email verification with Playwright and a real inbox

Test Clerk signup in Next.js with a fixed development code and a code delivered to a real inbox. Verify the primary email on a protected page after reload.

By MailSlurpPublished

Use with your tools
Clerk

Clerk gives a Next.js app a sign-up form, an email challenge and a session. Testing the part between those screens takes more work. A form test can accept a development code while a new customer is still waiting for an email. To check what the customer experiences, the test needs an address it can open and the code Clerk actually sent there.

We'll use Playwright for the browser and MailSlurp for the mailbox. We'll visit a protected account page as a guest, complete signup, reload, and check which email Clerk verified. You can run the fast development-code test on each change and the real-delivery test when you need to check the sender, message, and form together.

How do I set up Clerk authentication in my web app?

For a Next.js App Router project, wrap the app in ClerkProvider, add clerkMiddleware() in proxy.js, and render Clerk's sign-up form on your signup route. In this example the provider redirects successful signups to /account. That page reads the user on the server, so you can check whether the address that received the code is the one Clerk verified.

Open the Next.js example on GitHub. Clone the repository and open clerk-email-verification. Use Node.js 22.13 or newer and a dedicated Clerk development application with email-address signup and email-code verification. The sample handles an optional password field. If your signup requires additional profile fields, fill those in the test too. Clerk signup form testing

npm ci
npx playwright install chromium
cp .env.example .env.local

In .env.local, set NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY and CLERK_SECRET_KEY from the same development application. Add MAILSLURP_API_KEY for the real-email test. Only the publishable key belongs in browser code. Playwright starts the app on localhost.

Check the form with Clerk's reserved address

Run npm test -- --grep 'reserved test'. The test visits /account as a guest, follows the redirect to signup, and uses a unique address with Clerk's +clerk_test suffix. In development, Clerk accepts 424242 for that address. This checks that the form, redirect and protected page work without waiting for a message. Clerk test emails and phones

Submit the code from a real email

Run npm test -- --grep 'real signup'. This time Playwright enters the address of a new MailSlurp inbox. The runner records the submit time, clicks Continue, and waits for Clerk's verification field. That field tells us the browser is ready for a code.

Clerk waits here while the runner reads the message. The recipient address is masked.

The runner waits for an email sent to that inbox after the form submission. It reads the text lines of that same message, requires a single distinct six-digit value, and enters it in the verification field:

const email = await mail.waitController.waitForLatestEmail({
  inboxId: inbox.id, since, timeout: 90000
});
const { lines } = await mail.emailController.getEmailTextLines({ emailId: email.id });
const codes = new Set(lines.join('\n').match(/\b\d{6}\b/g));
if (codes.size !== 1) throw new Error('Expected one verification code.');
await input.pressSequentially([...codes][0]);

What should be included in an OTP email to ensure user trust?

Identify the application, state what the code is for, and explain what the recipient should do if the request was unexpected. The Clerk development email in this example repeated the digits in the subject and body, named the application, and warned the recipient against sharing the code. When you customize the template, give the app a name your users recognize and rerun the test against that template.

Excerpt of the delivered development email. The six digits in the subject and body are masked.

Verify the primary email after a reload

On /account, the Next.js server calls currentUser() and looks up the address matching primaryEmailAddressId. After reload the test requires the exact recipient address and the status verified:

await page.waitForURL('**/account');
await page.reload();
await expect(page.getByLabel('Account email')).toHaveText(inbox.emailAddress);
await expect(page.getByText('verified', { exact: true })).toBeVisible();
The server read back the same address that received the code.

If the reserved-address test passes and the delivery test times out, first check which address signup submitted. A reserved address takes the simulated path. For an ordinary address, check the instance's daily recipient limit and the test's inbox ID. If mail arrived and the page still redirects to signup, inspect the verification result and any additional fields required by your Clerk instance. The test deletes its temporary inbox; the development user remains in Clerk.