Testing

Decision Tree

Mental Model

• clerkSetup()

  initializes test environment

• setupClerkTestingToken()

  bypasses bot detection

• storageState

  persists auth between tests for speed

Workflow

1. Identify test framework (Playwright or Cypress)
2. WebFetch the appropriate URL from decision tree above
3. Follow official setup instructions
4. Use

   pk_test_*

   and

   sk_test_*

   keys only

Best Practices

• Use

  setupClerkTestingToken()

  before navigating to auth pages
• Use test API keys:

  pk_test_xxx

  ,

  sk_test_xxx

• Save auth state with

  storageState

  for faster tests
• Use

  page.waitForSelector('[data-clerk-component]')

  for Clerk UI

Anti-Patterns

pk_test_*

setupClerkTestingToken()

storageState

Framework-Specific

globalSetup

addClerkCommands({ Cypress, cy })

See Also

• Demo Repo