The Element class represents an element in the Dendrite browser environment. It wraps a Playwright Locator and provides methods for interacting with and manipulating elements in the browser.

​
Methods

​
outer_html

Retrieves the outer HTML of the element.

​
Usage

html = await element.outer_html()

​
Returns

  • str: The outer HTML of the element.

​
screenshot

Takes a screenshot of the element and returns it as a base64-encoded string.

​
Usage

screenshot = await element.screenshot()

​
Returns

  • str: A base64-encoded string of the JPEG image. Returns an empty string if the screenshot fails.

​
click

Clicks the element.

​
Usage

await element.click(expected_outcome="The dropdown menu should open")

​
Arguments

  • expected_outcome (Optional[str]): The expected outcome of the click action.
  • *args: Additional positional arguments.
  • **kwargs: Additional keyword arguments.

​
Returns

  • InteractionResponse: The response from the interaction.

​
fill

Fills the element with a value.

​
Usage

await element.fill("John Doe", expected_outcome="The input field should contain the entered name")

​
Arguments

  • value (str): The value to fill the element with.
  • expected_outcome (Optional[str]): The expected outcome of the fill action.
  • *args: Additional positional arguments.
  • **kwargs: Additional keyword arguments.

​
Returns

  • InteractionResponse: The response from the interaction.

​
hover

Hovers over the element.

​
Usage

await element.hover(expected_outcome="A tooltip should appear")

​
Arguments

  • expected_outcome (Optional[str]): The expected outcome of the hover action.
  • *args: Additional positional arguments.
  • **kwargs: Additional keyword arguments.

​
Returns

  • InteractionResponse: The response from the interaction.

​
highlight

Highlights the element for debugging purposes.

​
Usage

await element.highlight()
This method is useful for visually identifying elements during development and debugging.