# TimeoutError: waiting for selector (Playwright)

Source: https://www.observeone.com/community/errors/playwright/waiting-for-selector

[ObserveOne](/)[Features](/#features)[Pricing](/#pricing)[Blog](/blog)[CLI](/cli)[Docs](/docs)

[Sign in](https://app.observeone.com/auth?tab=signin)[Start Free](https://app.observeone.com/auth?tab=signup)

[Error Dictionary](/community/errors)/[Playwright](/community/errors/playwright)/waiting-for-selectorhigh

# TimeoutError: waiting for selector

Playwright waited for an element matching the given selector but it did not appear within the timeout. The element may not exist, may be hidden, or may appear under a different selector.

## Common Causes

- 1Selector typo or incorrect CSS/XPath expression
- 2Element is rendered dynamically and hasn't appeared yet
- 3Element exists but is hidden (display: none or visibility: hidden)
- 4Element is inside a shadow DOM or iframe
- 5Page content changed and the selector no longer matches

## How to Fix

### Use Playwright's auto-waiting locators

// Instead of:
await page.waitForSelector('#button');
await page.click('#button');

// Use:
await page.locator('#button').click();Playwright locators automatically wait for elements. No need for explicit waitForSelector in most cases.

### Debug with page.locator().count()

const count = await page.locator('#button').count();
console.log('Elements found:', count);Check if the selector matches any elements at all. Helps distinguish between 'wrong selector' and 'element not loaded yet'.

### Handle iframes explicitly

const frame = page.frameLocator('#my-iframe');
await frame.locator('#button').click();If the element is inside an iframe, you need to use frameLocator to access it.

## How ObserveOne Helps

ObserveOne's self-healing selectors automatically detect when selectors break and suggest fixes based on AI analysis.

[Start Monitoring Free](https://app.observeone.com/auth?tab=signup)

## Related Errors

[TimeoutError: Exceeded 30000msThe default action timeout (30 seconds) was exceeded before the operation could complete. This commonly occurs during navigation, element waits, or network-dependent operations.](/community/errors/playwright/timeout-30000ms)[Error: strict mode violation: locator resolved to N elementsA locator matched more than one element, but the action requires exactly one. Playwright's strict mode (enabled by default) prevents ambiguous interactions.](/community/errors/playwright/strict-mode-violation)[Error: element is not visibleThe target element exists in the DOM but is not visible. Playwright requires elements to be visible before interacting with them (clicking, typing, etc.).](/community/errors/playwright/element-not-visible)[TimeoutError: page.goto: Timeout 30000ms exceededNavigation to the target URL did not complete within the timeout period. The page either failed to respond or took too long to reach the 'load' event.](/community/errors/playwright/navigation-timeout)[Error: element is intercepted by another elementAnother element (like a modal, overlay, or tooltip) is covering the target element, preventing Playwright from clicking it.](/community/errors/playwright/element-intercepted)

ObserveOne

Agentic QA and synthetic monitoring built for engineering teams. Plan, generate, and run suites from the web UI. Connect to CI for reliable coverage across critical journeys.

### Product

- [Features](/#features)
- [Pricing](/#pricing)
- [QA Coverage](/qa-coverage)
- [API Monitoring](/api-monitoring)
- [Free Website Check](/free-website-check)

### Developers

- [CLI](/cli)
- [Docs](/docs)
- [For Agents](/agents)
- [Self-host (oo-workers)](/workers)
- [Status Pages](/status)
- [Netlify Extension](https://app.netlify.com/extensions/mzs1lgc3-observeone)

### Resources

- [Blog](/blog)
- [Bug Book](/bug-book)
- [Guides](/community/guides)
- [Tools](/community/tools)
- [Error Dictionary](/community/errors)

### Compare

- [Tool Comparisons](/compare)
- [Tool Alternatives](/alternatives)
- [Best by Category](/best)
- [Search](/search)

© 2026 ObserveOne. All rights reserved.

[About](/about)[Privacy Policy](/privacy)[Terms of Service](/terms)[Affiliates](/affiliates)[Become an Affiliate](/affiliate-terms)
