Element Handle represents a remote element in the DOM of the browser. It implements useful methods for querying and interacting with DOM elements.
note
All methods on this class are asynchronous and must be used with await to wait for the result to fulfill from the browser.
Usage#
Methods#
blur()#
Clears focus from this element so that it will no longer receive keyboard inputs.
Parameters
- returns:
Promise<void>
clear()#
Schedules a command to clear the value of this element. This command has no effect if the underlying DOM element is neither a text INPUT, SELECT, or a TEXTAREA element.
Parameters
- returns:
Promise<void>
click([, options])#
Sends a click event to the element attached to this handle. If the element is currently outside the viewport it will first scroll to that element.
Parameters
- options?
ClickOptions(Optional) - returns:
Promise<void>
dispose()#
Parameters
- returns:
Promise<void>
findElement(locator)#
Locates an element using the supplied Locator, returning an ElementHandle.
Parameters
- locator
string|Locator - returns: Promise<[
ElementHandle][ElementHandle] |null>
findElements(locator)#
Locates all elements using the supplied Locator, returning an array of ElementHandles.
Parameters
- locator
Locator|string - returns: Promise<[
ElementHandle][ElementHandle][]>
focus()#
Sends focus to this element so that it receives keyboard inputs.
Parameters
- returns:
Promise<void>
getAttribute(key)#
Fetches the value of an attribute on this element
Parameters
- key
string - returns:
Promise<string | null>
getId()#
Fetches the remote elements id attribute.
Parameters
- returns:
Promise<string | null>
getProperty(key)#
getProperty
Parameters
- key
string - returns:
Promise<string | null>
highlight()#
Parameters
- returns:
Promise<void>
isDisplayed()#
Checks whether the remote element is displayed in the DOM and is visible to the user without being hidden by CSS or occluded by another element.
Parameters
- returns:
Promise<boolean>
isEnabled()#
Checks whether the remote element is enabled. Typically this means it does not have a disabled property or attribute applied.
Parameters
- returns:
Promise<boolean>
isSelectable()#
Checks whether the remote element is selectable. An element is selectable if it is an <option> or input[type="checkbox"] or radio button.
Parameters
- returns:
Promise<boolean>
isSelected()#
If the remote element is selectable (such as an <option> or input[type="checkbox"]) this methos will indicate whether it is selected.
Parameters
- returns:
Promise<boolean>
location()#
Fetches the remote elements physical location as x and y.
Parameters
- returns:
Promise<Location>
sendKeys(...keys)#
Sends a series of key modifiers to the element.
Parameters
- keys
string[] - returns:
Promise<void>
size()#
Fetches the remote elements physical dimensions as width and height.
Parameters
- returns:
Promise<Size>
tagName()#
Fetches the remote elements tagName property.
Parameters
- returns:
Promise<string | null>
takeScreenshot([, options])#
Takes a screenshot of this element and saves it to the results folder with a random name.
Parameters
- options?
ScreenshotOptions(Optional) - returns:
Promise<void>
text()#
Retrieves the text content of this element excluding leading and trailing whitespace.
Parameters
- returns:
Promise<string>
type(text)#
Sends a series of key presses to the element to simulate a user typing on the keyboard. Use this to fill in input fields.
Parameters
- text
string - returns:
Promise<void>