Trouble Shotting and Debugging

Common Issues

Element Selection Problems

Issue: Elements not found or interactions failingSolutions:

Use browser dev tools to test selectors
Add explicit waits for dynamic content
Use more specific or stable selectors
Check for iframe or shadow DOM elements

Timing and Race Conditions

Issue: Tests failing due to timing issuesSolutions:

Use waitForSelector() instead of fixed delays
Wait for network requests to complete
Use waitForLoadState() for page readiness
Implement proper error handling and retries

Authentication and Session Issues

Issue: Login failures or session timeoutsSolutions:

Verify credentials are correct and active
Handle multi-factor authentication scenarios
Use session storage for authentication state
Test login flow separately from main workflow

Performance and Timeout Issues

Issue: Tests timing out or running too slowlySolutions:

Optimize page load performance
Increase timeout values for slow operations
Use parallel execution where possible
Monitor and alert on performance degradation

Error Handling and Debugging

Wait Strategies

// Wait for specific conditions
await page.waitForSelector('[data-testid="loading-complete"]')
await page.waitForURL('**/dashboard')
await page.waitForFunction(() => window.dataLoaded === true)

// Wait for network requests
await page.waitForResponse(response => 
  response.url().includes('/api/user') && response.status() === 200
)

// Timeout configuration
await page.waitForSelector('.slow-element', { timeout: 30000 })

Error Recovery

// Graceful error handling
try {
  await page.click('.optional-popup-close', { timeout: 5000 })
} catch (error) {
  // Continue if popup doesn't appear
  console.log('No popup to close')
}

// Conditional interactions
const isLoggedIn = await page.locator('.user-menu').isVisible()
if (!isLoggedIn) {
  await page.click('.login-button')
  // Handle login flow
}

⌘I

Getting Started

Detect

Communicate

Resolve

AI

Integrations

Trouble Shotting and Debugging

Common Issues

Error Handling and Debugging

​Common Issues

​Error Handling and Debugging

Common Issues

Error Handling and Debugging