Struct chromiumoxide::page::Page

pub struct Page { /* fields omitted */ }

Implementations

impl Page

pub async fn execute<T: Command, '_>(
    &'_ self,
    cmd: T
) -> Result<CommandResponse<T::Response>>

Execute a command and return the Command::Response

pub async fn wait_for_navigation<'_, '_>(&'_ self) -> Result<&'_ Self>

This resolves once the navigation finished and the page is loaded.

This is necessary after an interaction with the page that may trigger a navigation (click, press_key) in order to wait until the new browser page is loaded

pub async fn goto<'_, '_>(
    &'_ self,
    params: impl Into<NavigateParams>
) -> Result<&'_ Self>

Navigate directly to the given URL.

This resolves directly after the requested URL is fully loaded.

pub fn target_id(&self) -> &TargetId

The identifier of the Target this page belongs to

pub fn session_id(&self) -> &SessionId

The identifier of the Session target of this page is attached to

pub async fn url<'_>(&'_ self) -> Result<Option<String>>

Returns the current url of the page

pub async fn mainframe<'_>(&'_ self) -> Result<Option<FrameId>>

Return the main frame of the page

pub async fn set_user_agent<'_, '_>(
    &'_ self,
    params: impl Into<SetUserAgentOverrideParams>
) -> Result<&'_ Self>

Allows overriding user agent with the given string.

pub async fn get_document<'_>(&'_ self) -> Result<Node>

Returns the root DOM node (and optionally the subtree) of the page.

Note: This does not return the actual HTML document of the page. To

retrieve the HTML content of the page see Page::content.

pub async fn find_element<'_>(
    &'_ self,
    selector: impl Into<String>
) -> Result<Element>

Returns the first element in the document which matches the given CSS selector.

Execute a query selector on the document's node.

pub async fn find_elements<'_>(
    &'_ self,
    selector: impl Into<String>
) -> Result<Vec<Element>>

Return all Elements in the document that match the given selector

pub async fn describe_node<'_>(&'_ self, node_id: NodeId) -> Result<Node>

Describes node given its id

pub async fn close(self)

pub async fn move_mouse_to_point<'_, '_>(
    &'_ self,
    point: Point
) -> Result<&'_ Self>

Moves the mouse to this point (dispatches a mouseMoved event)

pub async fn click<'_, '_>(&'_ self, point: Point) -> Result<&'_ Self>

Performs a mouse click event at the point's location.

Bear in mind that if click() triggers a navigation the new page is not immediately loaded when click() resolves. To wait until navigation is finished an additional wait_for_navigation() is required:

Example

Trigger a navigation and wait until the triggered navigation is finished

    let html = page.click(point).await?.wait_for_navigation().await?.content();

pub async fn pdf<'_>(&'_ self, opts: PrintToPdfParams) -> Result<Vec<u8>>

Print the current page as pdf.

See PrintToPdfParams

Note Generating a pdf is currently only supported in Chrome headless.

pub async fn save_pdf<'_>(
    &'_ self,
    opts: PrintToPdfParams,
    output: impl AsRef<Path>
) -> Result<Vec<u8>>

Save the current page as pdf as file to the output path and return the pdf contents.

Note Generating a pdf is currently only supported in Chrome headless.

pub async fn enable_log<'_, '_>(&'_ self) -> Result<&'_ Self>

Enables log domain. Enabled by default.

Sends the entries collected so far to the client by means of the entryAdded notification.

See https://chromedevtools.github.io/devtools-protocol/tot/Log#method-enable

pub async fn disable_log<'_, '_>(&'_ self) -> Result<&'_ Self>

Disables log domain

Prevents further log entries from being reported to the client

See https://chromedevtools.github.io/devtools-protocol/tot/Log#method-disable

pub async fn enable_runtime<'_, '_>(&'_ self) -> Result<&'_ Self>

Enables runtime domain. Activated by default.

pub async fn disable_runtime<'_, '_>(&'_ self) -> Result<&'_ Self>

Disables runtime domain

pub async fn enable_debugger<'_, '_>(&'_ self) -> Result<&'_ Self>

Enables Debugger. Enabled by default.

pub async fn disable_debugger<'_, '_>(&'_ self) -> Result<&'_ Self>

Disables Debugger.

pub async fn activate<'_, '_>(&'_ self) -> Result<&'_ Self>

Activates (focuses) the target.

pub async fn get_cookies<'_>(&'_ self) -> Result<Vec<Cookie>>

Returns all cookies that match the tab's current URL.

pub async fn get_title<'_>(&'_ self) -> Result<Option<String>>

Returns the title of the document.

pub async fn evaluate<'_>(
    &'_ self,
    evaluate: impl Into<EvaluateParams>
) -> Result<RemoteObject>

Evaluates expression on global object.

pub async fn content<'_>(&'_ self) -> Result<String>

Returns the HTML content of the page

pub async fn get_script_source<'_>(
    &'_ self,
    script_id: impl Into<String>
) -> Result<String>

Returns source for the script with given id.

Debugger must be enabled.

Trait Implementations

impl Debug for Page

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

Formats the value using the given formatter.

impl From<Arc<PageInner>> for Page

pub fn from(inner: Arc<PageInner>) -> Self

Performs the conversion.