Struct headless_chrome::browser::tab::element::Element

pub struct Element<'a> {
    pub remote_object_id: String,
    pub backend_node_id: NodeId,
    pub parent: &'a Tab,
}

A handle to a DOM Element.

Typically you get access to these by passing Tab.wait_for_element a CSS selector. Once you have a handle to an element, you can click it, type into it, inspect its attributes, and more. You can even run a JavaScript function inside the tab which can reference the element via this.

Fields

remote_object_id: String

backend_node_id: NodeId

parent: &'a Tab

Methods

impl<'a> Element<'a>

pub fn new(parent: &'a Tab, node_id: NodeId) -> Fallible<Self>

Using a 'node_id', of the type returned by QuerySelector and QuerySelectorAll, this finds the 'backend_node_id' and 'remote_object_id' which are stable identifiers, unlike node_id. We use these two when making various calls to the API because of that.

pub fn move_mouse_over(&self) -> Fallible<&Self>

Moves the mouse to the middle of this element

pub fn click(&self) -> Fallible<&Self>

pub fn type_into(&self, text: &str) -> Fallible<&Self>

pub fn call_js_fn(
    &self,
    function_declaration: &str,
    await_promise: bool
) -> Fallible<RemoteObject>

pub fn focus(&self) -> Fallible<&Self>

pub fn get_description(&self) -> Fallible<Node>

pub fn capture_screenshot(&self, format: ScreenshotFormat) -> Fallible<Vec<u8>>

Capture a screenshot of this element.

The screenshot is taken from the surface using this element's content-box.

use headless_chrome::{protocol::page::ScreenshotFormat, Browser, LaunchOptionsBuilder};
let browser = Browser::new(LaunchOptionsBuilder::default().build().unwrap())?;
let png_data = browser.wait_for_initial_tab()?
    .navigate_to("https://en.wikipedia.org/wiki/WebKit")?
    .wait_for_element("#mw-content-text > div > table.infobox.vevent")?
    .capture_screenshot(ScreenshotFormat::PNG)?;

pub fn set_input_files(&self, file_paths: &[&str]) -> Fallible<&Self>

pub fn scroll_into_view(&self) -> Fallible<&Self>

Scrolls the current element into view

Used prior to any action applied to the current element to ensure action is duable.

pub fn get_attributes(&self) -> Fallible<Option<NodeAttributes>>

pub fn get_box_model(&self) -> Fallible<BoxModel>

Get boxes for this element

pub fn get_midpoint(&self) -> Fallible<Point>

pub fn get_js_midpoint(&self) -> Fallible<Point>

Trait Implementations

impl<'a> Debug for Element<'a>

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

Formats the value using the given formatter.