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

Trait Implementations

impl ChannelOwner for ElementHandle

fn guid(&self) -> &str

Returns the unique GUID for this object.

fn type_name(&self) -> &str

Returns the protocol type name (e.g., “Browser”, “Page”).

fn parent(&self) -> Option<Arc<dyn ChannelOwner>>

Returns the parent object, if any.

fn connection(&self) -> Arc<dyn ConnectionLike>

Returns the connection this object belongs to.

fn initializer(&self) -> &Value

Returns the raw initializer JSON from the server.

fn channel(&self) -> &Channel

Returns the channel for RPC communication.

fn dispose(&self, reason: DisposeReason)

Disposes this object and all its children.

fn adopt(&self, child: Arc<dyn ChannelOwner>)

Adopts a child object (moves from old parent to this parent).

fn add_child(&self, guid: Arc<str>, child: Arc<dyn ChannelOwner>)

Adds a child object to this parent’s registry.

fn remove_child(&self, guid: &str)

Removes a child object from this parent’s registry.

fn on_event(&self, _method: &str, _params: Value)

Handles a protocol event sent to this object.

fn was_collected(&self) -> bool

Returns true if this object was garbage collected.

fn as_any(&self) -> &dyn Any

Enables downcasting to concrete types.

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.