Menu
Open source
waitForSelector(selector[, options])
Note
Use web assertions that assert visibility or a locator-based
locator.waitFor([options])instead.
Returns when element specified by selector satisfies state option.
| Parameter | Type | Default | Description |
|---|---|---|---|
| selector | string | '' | A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. |
| options | object | null | |
| options.state | string | visible | Can be either attached, detached, visible, hidden See Element states for more details. |
| options.strict | boolean | false | When true, the call requires selector to resolve to a single element. If given selector resolves to more than one element, the call throws an exception. |
| options.timeout | number | 30000 | Maximum time in milliseconds. Pass 0 to disable the timeout. Default is overridden by the setDefaultTimeout option on
BrowserContext or
Page. |
Element states
Element states can be either:
'attached'- wait for element to be present in DOM.'detached'- wait for element to not be present in DOM.'visible'- wait for element to have non-empty bounding box and novisibility:hidden.'hidden'- wait for element to be either detached from DOM, or have an empty bounding box orvisibility:hidden.
Returns
| Type | Description |
|---|---|
Promise<ElementHandle | null> | A Promise that fulfills with the
ElementHandle when a matching element is found, or null if the element is not found. |
