Struct Frame 

pub struct Frame { /* private fields */ }

Frame represents a frame within a page.

Every page has a main frame, and pages can have additional child frames (iframes). Frame is where navigation, selector queries, and DOM operations actually happen.

In Playwright’s architecture, Page delegates navigation and interaction methods to Frame.

See: https://playwright.dev/docs/api/class-frame

Implementations

impl Frame

pub fn new( parent: Arc<dyn ChannelOwner>, type_name: String, guid: Arc<str>, initializer: Value, ) -> Result<Self>

Creates a new Frame from protocol initialization

This is called by the object factory when the server sends a __create__ message for a Frame object.

pub async fn goto( &self, url: &str, options: Option<GotoOptions>, ) -> Result<Option<Response>>

Navigates the frame to the specified URL.

This is the actual protocol method for navigation. Page.goto() delegates to this.

Returns None when navigating to URLs that don’t produce responses (e.g., data URLs, about:blank). This matches Playwright’s behavior across all language bindings.

Arguments

• url - The URL to navigate to
• options - Optional navigation options (timeout, wait_until)

See: https://playwright.dev/docs/api/class-frame#frame-goto

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

Returns the frame’s title.

See: https://playwright.dev/docs/api/class-frame#frame-title

pub async fn query_selector( &self, selector: &str, ) -> Result<Option<Arc<ElementHandle>>>

Returns the first element matching the selector, or None if not found.

See: https://playwright.dev/docs/api/class-frame#frame-query-selector

pub async fn query_selector_all( &self, selector: &str, ) -> Result<Vec<Arc<ElementHandle>>>

Returns all elements matching the selector.

See: https://playwright.dev/docs/api/class-frame#frame-query-selector-all

Trait Implementations

impl ChannelOwner for Frame

fn guid(&self) -> &str

Returns the unique GUID for this object.

fn type_name(&self) -> &str

Returns the protocol type name (e.g., “Browser”, “Page”).

fn parent(&self) -> Option<Arc<dyn ChannelOwner>>

Returns the parent object, if any.

fn connection(&self) -> Arc<dyn ConnectionLike>

Returns the connection this object belongs to.

fn initializer(&self) -> &Value

Returns the raw initializer JSON from the server.

fn channel(&self) -> &Channel

Returns the channel for RPC communication.

fn dispose(&self, reason: DisposeReason)

Disposes this object and all its children.

fn adopt(&self, child: Arc<dyn ChannelOwner>)

Adopts a child object (moves from old parent to this parent).

fn add_child(&self, guid: Arc<str>, child: Arc<dyn ChannelOwner>)

Adds a child object to this parent’s registry.

fn remove_child(&self, guid: &str)

Removes a child object from this parent’s registry.

fn on_event(&self, _method: &str, _params: Value)

Handles a protocol event sent to this object.

fn was_collected(&self) -> bool

Returns true if this object was garbage collected.

fn as_any(&self) -> &dyn Any

Enables downcasting to concrete types.

impl Clone for Frame

fn clone(&self) -> Frame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Frame

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

Formats the value using the given formatter.