Struct Page 

pub struct Page { /* private fields */ }

Implementations

impl Page

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

Navigate to URL (returns immediately, does not wait for load).

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

Navigate to URL and wait for page load.

pub async fn wait_for_load(&self) -> Result<()>

Wait for next navigation/load event.

pub async fn js(&self, expr: &str) -> Result<String>

Run JS expression in page context, return result as String.

Examples found in repository

examples/youtube_test.rs (line 17)

async fn main() {
    println!("=== YouTube Test ===\n");

    let browser = Browser::builder()
        .headful()
        .profile(7, 777)
        .build()
        .await
        .expect("launch failed");

    let page = browser.new_page("https://www.youtube.com").await.expect("nav failed");
    page.wait(3000).await;

    let title = page.js("document.title").await.unwrap_or_default();
    let url = page.url().await.unwrap_or_default();
    println!("Title: {title}");
    println!("URL: {url}");

    println!("\nBrowser open. Ctrl+C to exit.");
    loop {
        tokio::time::sleep(std::time::Duration::from_secs(60)).await;
    }
}

examples/smoke_test.rs (line 24)

async fn main() {
    println!("=== Smoke Test ===\n");

    let browser = Browser::builder()
        .headful()
        .profile(7, 777)
        .build()
        .await
        .expect("launch failed");

    let page = browser.new_page("about:blank").await.expect("page failed");

    let checks = &[
        ("webdriver", "navigator.webdriver.toString()"),
        ("timezone", "Intl.DateTimeFormat().resolvedOptions().timeZone"),
        ("cores", "navigator.hardwareConcurrency.toString()"),
        ("screen", "screen.width+'x'+screen.height"),
        ("UA", "navigator.userAgent"),
    ];
    for (name, expr) in checks {
        let val = page.js(expr).await.unwrap_or_default();
        println!("{name}: {val}");
    }

    println!("\nBrowser open. Ctrl+C to exit.");
    loop {
        tokio::time::sleep(std::time::Duration::from_secs(60)).await;
    }
}

pub async fn js_as<T: DeserializeOwned>(&self, expr: &str) -> Result<T>

Run JS and deserialize result into T.

pub async fn js_on_new_document(&self, script: &str) -> Result<()>

Inject script that runs on every new document before page JS.

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

Current page URL.

Examples found in repository

examples/youtube_test.rs (line 18)

async fn main() {
    println!("=== YouTube Test ===\n");

    let browser = Browser::builder()
        .headful()
        .profile(7, 777)
        .build()
        .await
        .expect("launch failed");

    let page = browser.new_page("https://www.youtube.com").await.expect("nav failed");
    page.wait(3000).await;

    let title = page.js("document.title").await.unwrap_or_default();
    let url = page.url().await.unwrap_or_default();
    println!("Title: {title}");
    println!("URL: {url}");

    println!("\nBrowser open. Ctrl+C to exit.");
    loop {
        tokio::time::sleep(std::time::Duration::from_secs(60)).await;
    }
}

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

Page title.

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

Full page HTML.

pub async fn screenshot(&self) -> Result<Vec<u8>>

Capture PNG screenshot.

pub async fn click(&self, x: f64, y: f64) -> Result<()>

Click at (x, y) with realistic mouse movement + timing.

pub async fn type_text(&self, text: &str) -> Result<()>

Type text into focused element with realistic keystroke timing.

pub async fn scroll(&self, delta_y: f64) -> Result<()>

Scroll by delta_y pixels (positive = down).

pub async fn wait(&self, ms: u64)

Sleep for ms milliseconds.

Examples found in repository

examples/youtube_test.rs (line 15)

async fn main() {
    println!("=== YouTube Test ===\n");

    let browser = Browser::builder()
        .headful()
        .profile(7, 777)
        .build()
        .await
        .expect("launch failed");

    let page = browser.new_page("https://www.youtube.com").await.expect("nav failed");
    page.wait(3000).await;

    let title = page.js("document.title").await.unwrap_or_default();
    let url = page.url().await.unwrap_or_default();
    println!("Title: {title}");
    println!("URL: {url}");

    println!("\nBrowser open. Ctrl+C to exit.");
    loop {
        tokio::time::sleep(std::time::Duration::from_secs(60)).await;
    }
}

pub async fn close(self) -> Result<()>

Close the page/tab.

pub fn cdp(&self) -> &CdpPage

Access underlying chromiumoxide Page for raw CDP.