Struct Element 

pub struct Element { /* private fields */ }

A handle to a DOM element in a browser tab.

Elements are identified by a UUID stored in the extension’s content script. Operations use generic dynamic property access (element[method]()).

Example

let element = tab.find_element("input[name='email']").await?;

// Set value and submit
element.set_value("user@example.com").await?;
element.type_text("\n").await?; // Press Enter

Implementations

impl Element

pub fn id(&self) -> &ElementId

Returns this element’s ID.

pub fn tab_id(&self) -> TabId

Returns the tab ID where this element exists.

pub fn frame_id(&self) -> FrameId

Returns the frame ID where this element exists.

impl Element

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

Clicks the element.

Uses element.click() internally.

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

Focuses the element.

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

Blurs (unfocuses) the element.

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

Clears the element’s value.

Sets element.value = "".

impl Element

pub async fn get_text(&self) -> Result<String>

Gets the element’s text content.

pub async fn get_inner_html(&self) -> Result<String>

Gets the element’s inner HTML.

pub async fn get_value(&self) -> Result<String>

Gets the element’s value (for input elements).

pub async fn set_value(&self, value: &str) -> Result<()>

Sets the element’s value (for input elements).

pub async fn get_attribute(&self, name: &str) -> Result<Option<String>>

Gets an attribute value.

Returns None if the attribute doesn’t exist.

pub async fn is_displayed(&self) -> Result<bool>

Checks if the element is displayed.

Returns false if offsetParent is null (element is hidden).

pub async fn is_enabled(&self) -> Result<bool>

Checks if the element is enabled.

Returns true if disabled property is false or absent.

impl Element

pub async fn type_key( &self, key: &str, code: &str, key_code: u32, printable: bool, ctrl: bool, shift: bool, alt: bool, meta: bool, ) -> Result<()>

Types a single key with optional modifiers.

Dispatches full keyboard event sequence: keydown → input → keypress → keyup.

Arguments

• key - Key value (e.g., “a”, “Enter”)
• code - Key code (e.g., “KeyA”, “Enter”)
• key_code - Legacy keyCode number
• printable - Whether key produces visible output
• ctrl - Ctrl modifier
• shift - Shift modifier
• alt - Alt modifier
• meta - Meta modifier

pub async fn type_char(&self, c: char) -> Result<()>

Types a character with default key properties.

Convenience method that uses type_text internally for reliability.

pub async fn type_text(&self, text: &str) -> Result<()>

Types a text string character by character.

Each character goes through full keyboard event sequence. This is slower but more realistic than set_value.

Example

element.type_text("Hello, World!").await?;

impl Element

pub async fn mouse_click(&self, button: u8) -> Result<()>

Clicks the element using mouse events.

Dispatches: mousemove → mousedown → mouseup → click. This is more realistic than click() which uses element.click().

Arguments

• button - Mouse button (0=left, 1=middle, 2=right)

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

Moves mouse to the element center.

pub async fn mouse_down(&self, button: u8) -> Result<()>

Presses mouse button down on the element (without release).

Dispatches only mousedown event. Use with mouse_up() for drag operations.

Arguments

• button - Mouse button (0=left, 1=middle, 2=right)

pub async fn mouse_up(&self, button: u8) -> Result<()>

Releases mouse button on the element.

Dispatches only mouseup event. Use with mouse_down() for drag operations.

Arguments

• button - Mouse button (0=left, 1=middle, 2=right)

impl Element

pub async fn find_element(&self, selector: &str) -> Result<Element>

Finds a child element by CSS selector.

Errors

Returns Error::ElementNotFound if no matching element exists.

pub async fn find_elements(&self, selector: &str) -> Result<Vec<Element>>

Finds all child elements matching a CSS selector.

Returns an empty vector if no elements match.

impl Element

pub async fn get_property(&self, name: &str) -> Result<Value>

Gets a property value via element[name].

Arguments

• name - Property name (e.g., “value”, “textContent”)

pub async fn set_property(&self, name: &str, value: Value) -> Result<()>

Sets a property value via element[name] = value.

Arguments

• name - Property name
• value - Value to set

pub async fn call_method(&self, name: &str, args: Vec<Value>) -> Result<Value>

Calls a method via element[name](...args).

Arguments

• name - Method name
• args - Method arguments

Trait Implementations

impl Clone for Element

fn clone(&self) -> Element

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Element

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

Formats the value using the given formatter.