noteUse 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 |
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 no visibility:hidden.
- 'hidden' - wait for element to be either detached from DOM, or have an empty bounding box or visibility:hidden.
Returns
Type | Description |
---|---|
null | ElementHandle | ElementHandle when a matching element is found. Else, it returns null. |