Struct Page 

pub struct Page { /* private fields */ }

A browser page (tab).

Implementations

impl Page

pub fn goto(&self, url: impl Into<String>) -> GotoBuilder<'_>

Navigate to a URL.

Returns a builder for configuring navigation options.

Example

use viewpoint_core::Page;
use viewpoint_core::DocumentLoadState;
use std::time::Duration;

// Simple navigation
page.goto("https://example.com").goto().await?;

// Navigation with options
page.goto("https://example.com")
    .wait_until(DocumentLoadState::DomContentLoaded)
    .timeout(Duration::from_secs(10))
    .goto()
    .await?;

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

Navigate to a URL and wait for the specified load state.

This is a convenience method that calls goto(url).goto().await.

Errors

Returns an error if:

• The page is closed
• Navigation fails
• The wait times out

pub async fn close(&mut self) -> Result<(), PageError>

Close this page.

Errors

Returns an error if closing fails.

pub fn target_id(&self) -> &str

Get the target ID.

pub fn session_id(&self) -> &str

Get the session ID.

pub fn frame_id(&self) -> &str

Get the main frame ID.

pub fn is_closed(&self) -> bool

Check if this page has been closed.

pub fn connection(&self) -> &Arc<CdpConnection>

Get a reference to the CDP connection.

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

Get the current page URL.

Errors

Returns an error if the page is closed or the evaluation fails.

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

Get the current page title.

Errors

Returns an error if the page is closed or the evaluation fails.

pub fn locator(&self, selector: impl Into<String>) -> Locator<'_>

Create a locator for elements matching a CSS selector.

Example

let button = page.locator("button.submit");
let items = page.locator(".list > .item");

pub fn get_by_text(&self, text: impl Into<String>) -> Locator<'_>

Create a locator for elements containing the specified text.

Example

let heading = page.get_by_text("Welcome");
let exact = page.get_by_text_exact("Welcome to our site");

pub fn get_by_text_exact(&self, text: impl Into<String>) -> Locator<'_>

Create a locator for elements with exact text content.

pub fn get_by_role(&self, role: AriaRole) -> RoleLocatorBuilder<'_>

Create a locator for elements with the specified ARIA role.

Example

let buttons = page.get_by_role(AriaRole::Button);
let submit = page.get_by_role(AriaRole::Button).with_name("Submit");

pub fn get_by_test_id(&self, test_id: impl Into<String>) -> Locator<'_>

Create a locator for elements with the specified test ID.

By default, looks for data-testid attribute.

Example

let button = page.get_by_test_id("submit-button");

pub fn get_by_label(&self, label: impl Into<String>) -> Locator<'_>

Create a locator for form controls by their associated label text.

Example

let email = page.get_by_label("Email address");

pub fn get_by_placeholder(&self, placeholder: impl Into<String>) -> Locator<'_>

Create a locator for inputs by their placeholder text.

Example

let search = page.get_by_placeholder("Search...");

Trait Implementations

impl Debug for Page

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

Formats the value using the given formatter.

impl<'a> Expectable<'a> for Page

type Assertions = PageAssertions<'a>

The assertion builder type for this value.

fn assertions(&'a self) -> Self::Assertions

Create an assertion builder for this value.