src/content/docs/linter/rules/no-playwright-wait-for-selector.mdx
import { Tabs, TabItem } from '@astrojs/starlight/components';
<Tabs> <TabItem label="JavaScript (and super languages)" icon="seti:javascript"> :::caution This rule is part of the [nursery](/linter/#nursery) group. This means that it is experimental and the behavior can change at any time. ::: ## Summary - Rule available since: `v2.4.2` - Diagnostic Category: [`lint/nursery/noPlaywrightWaitForSelector`](/reference/diagnostics#diagnostic-category) - This rule has an [**unsafe**](/linter/#unsafe-fixes) fix. - The default severity of this rule is [**information**](/reference/diagnostics#information). - This rule belongs to the following domains: - [`playwright`](/linter/domains#playwright) - Sources: - Same as [`playwright/no-wait-for-selector`](https://github.com/playwright-community/eslint-plugin-playwright/blob/main/docs/rules/no-wait-for-selector.md){
"linter": {
"rules": {
"nursery": {
"noPlaywrightWaitForSelector": "error"
}
}
}
}
Disallow using page.waitForSelector().
Playwright's page.waitForSelector() is discouraged in favor of more reliable locator-based APIs.
Using locators with assertions or actions automatically waits for elements to be ready.
await page.waitForSelector('.submit-button');
await page.waitForSelector('#dialog', { state: 'visible' });
await page.click('#dialog .button');
await page.locator('.submit-button').click();
await expect(page.locator('#dialog')).toBeVisible();
const button = page.getByRole('button', { name: 'Submit' });
await button.click();