Struct ElementHandle 

pub struct ElementHandle { /* private fields */ }

ElementHandle represents a DOM element in the page.

ElementHandles are created via page.query_selector() or frame.query_selector(). They are protocol objects that allow element-specific operations like taking screenshots.

See: https://playwright.dev/docs/api/class-elementhandle

Implementations

impl ElementHandle

pub fn new( parent: Arc<dyn ChannelOwner>, type_name: String, guid: Arc<str>, initializer: Value, ) -> Result<Self>

Creates a new ElementHandle from protocol initialization

This is called by the object factory when the server sends a __create__ message for an ElementHandle object.

pub async fn screenshot( &self, options: Option<ScreenshotOptions>, ) -> Result<Vec<u8>>

Takes a screenshot of the element and returns the image bytes.

The screenshot is captured as PNG by default.

Example

let playwright = Playwright::launch().await?;
let browser = playwright.chromium().launch().await?;
let page = browser.new_page().await?;
page.goto("https://example.com", None).await?;

let element = page.query_selector("h1").await?.expect("h1 not found");
let screenshot_bytes = element.screenshot(None).await?;

See: https://playwright.dev/docs/api/class-elementhandle#element-handle-screenshot

pub async fn bounding_box(&self) -> Result<Option<BoundingBox>>

Returns the bounding box of this element, or None if it is not visible.

The bounding box is in pixels, relative to the top-left corner of the page.

See: https://playwright.dev/docs/api/class-elementhandle#element-handle-bounding-box

pub async fn scroll_into_view_if_needed(&self) -> Result<()>

Scrolls this element into the viewport if it is not already visible.

See: https://playwright.dev/docs/api/class-elementhandle#element-handle-scroll-into-view-if-needed

Trait Implementations

impl Clone for ElementHandle

fn clone(&self) -> ElementHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ElementHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.