Skip to main content
Version: 21.3.8

LocatorOptions interface

Signature:

export interface LocatorOptions

Properties

PropertyModifiersTypeDescriptionDefault
ensureElementIsInTheViewportbooleanWhether to scroll the element into viewport if not in the viewprot already.true
timeoutnumber

Total timeout for the entire locator operation.

Pass 0 to disable timeout.

Page.getDefaultTimeout()
visibilityVisibilityOptionWhether to wait for the element to be visible or hidden. null to disable visibility checks.
waitForEnabledbooleanWhether to wait for input elements to become enabled before the action. Applicable to click and fill actions.true
waitForStableBoundingBoxbooleanWhether to wait for the element's bounding box to be same between two animation frames.true