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 async fn aria_snapshot(&self) -> Result<AriaSnapshot, PageError>

Capture an ARIA accessibility snapshot of this frame’s document.

The snapshot represents the accessible structure of the frame’s content as it would be exposed to assistive technologies. This is useful for accessibility testing and MCP (Model Context Protocol) integrations.

Node References

The snapshot includes node_ref on each element (format: e{backendNodeId}). These refs can be used with Page::element_from_ref() or Page::locator_from_ref() to interact with elements discovered in the snapshot.

Frame Boundaries

Any iframes within this frame are marked as frame boundaries in the snapshot with is_frame: true. Their content is NOT traversed (for security reasons). To capture multi-frame accessibility trees, use Page::aria_snapshot_with_frames().

Errors

Returns an error if:

• The frame is detached
• JavaScript evaluation fails
• The snapshot cannot be parsed

impl Frame

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 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.

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.

impl Frame

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 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.

impl Frame

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.