Struct Frame 

pub struct Frame { /* private fields */ }

A frame within a page.

Frames are separate browsing contexts, typically created by <iframe> elements. Each frame has its own DOM and JavaScript execution context.

Implementations

impl Frame

pub fn id(&self) -> &str

Get the unique frame identifier.

pub fn parent_id(&self) -> Option<&str>

Get the parent frame ID.

Returns None for the main frame.

pub fn is_main(&self) -> bool

Check if this is the main frame.

pub fn loader_id(&self) -> &str

Get the loader ID.

pub fn url(&self) -> String

Get the frame’s current URL.

pub fn name(&self) -> String

Get the frame’s name attribute.

pub fn is_detached(&self) -> bool

Check if the frame has been detached.

pub async fn content(&self) -> Result<String, PageError>

Get the frame’s HTML content.

Errors

Returns an error if the frame is detached or the evaluation fails.

pub async fn title(&self) -> Result<String, PageError>

Get the frame’s document title.

Errors

Returns an error if the frame is detached or the evaluation fails.

pub async fn goto(&self, url: &str) -> Result<(), NavigationError>

Navigate the frame to a URL.

Errors

Returns an error if the frame is detached or navigation fails.

pub async fn goto_with_options( &self, url: &str, wait_until: DocumentLoadState, timeout: Duration, ) -> Result<(), NavigationError>

Navigate the frame to a URL with options.

Errors

Returns an error if the frame is detached or navigation fails.

pub async fn set_content(&self, html: &str) -> Result<(), PageError>

Set the frame’s HTML content.

Errors

Returns an error if the frame is detached or setting content fails.

pub async fn wait_for_load_state( &self, state: DocumentLoadState, ) -> Result<(), NavigationError>

Wait for the frame to reach a specific load state.

Errors

Returns an error if the wait times out or the frame is detached.

pub async fn wait_for_load_state_with_timeout( &self, state: DocumentLoadState, timeout: Duration, ) -> Result<(), NavigationError>

Wait for the frame to reach a specific load state with timeout.

Errors

Returns an error if the wait times out or the frame is detached.

pub async fn child_frames(&self) -> Result<Vec<Frame>, PageError>

Get child frames of this frame.

Returns a list of frames that are direct children of this frame.

Errors

Returns an error if querying the frame tree fails.

pub async fn parent_frame(&self) -> Result<Option<Frame>, PageError>

Get the parent frame.

Returns None if this is the main frame.

Errors

Returns an error if querying the frame tree fails.

Trait Implementations

impl Debug for Frame

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

Formats the value using the given formatter.