Struct PageHandle

Source

pub struct PageHandle { /* private fields */ }

Expand description

§Example

use stygian_browser::{BrowserPool, BrowserConfig};
use stygian_browser::page::WaitUntil;
use std::time::Duration;

let pool = BrowserPool::new(BrowserConfig::default()).await?;
let handle = pool.acquire().await?;
let mut page = handle.browser().expect("valid browser").new_page().await?;
page.navigate("https://example.com", WaitUntil::DomContentLoaded, Duration::from_secs(30)).await?;
let html = page.content().await?;
drop(page); // closes the tab
handle.release().await;

Implementations§

Source §

impl PageHandle

Source

pub async fn navigate( &mut self, url: &str, condition: WaitUntil, nav_timeout: Duration, ) -> Result<()>

§Errors

the CDP call fails.

Source

pub async fn wait_for_selector( &self, selector: &str, wait_timeout: Duration, ) -> Result<()>

§Errors

within the given timeout.

Source

pub async fn set_resource_filter( &mut self, filter: ResourceFilter, ) -> Result<()>

Enables Fetch interception and spawns a background task that continues allowed requests and fails blocked ones with BlockedByClient. Any previously set filter task is cancelled first.

§Errors

Source

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

Return the current page URL (post-navigation, post-redirect).

internally by save_cookies; no extra network request is made. Returns an empty string if the URL is not yet set

§Errors

BrowserError::Timeout if it exceeds cdp_timeout.

§Example

use stygian_browser::{BrowserPool, BrowserConfig};
use stygian_browser::page::WaitUntil;
use std::time::Duration;

let pool = BrowserPool::new(BrowserConfig::default()).await?;
let handle = pool.acquire().await?;
let mut page = handle.browser().expect("valid browser").new_page().await?;
page.navigate("https://example.com", WaitUntil::DomContentLoaded, Duration::from_secs(30)).await?;
let url = page.url().await?;
println!("Final URL after redirects: {url}");

Source

pub fn status_code(&self) -> Result<Option<u16>>

Return the HTTP status code of the most recent main-frame navigation.

The status is captured from the Network.responseReceived CDP event wired up inside navigate, so it reflects the final response after any server-side redirects.

navigations, when navigate has not yet been called, or if the network event subscription failed.

§Errors

§Example

use stygian_browser::{BrowserPool, BrowserConfig};
use stygian_browser::page::WaitUntil;
use std::time::Duration;

let pool = BrowserPool::new(BrowserConfig::default()).await?;
let handle = pool.acquire().await?;
let mut page = handle.browser().expect("valid browser").new_page().await?;
page.navigate("https://example.com", WaitUntil::DomContentLoaded, Duration::from_secs(30)).await?;
if let Some(code) = page.status_code()? {
    println!("HTTP {code}");
}

Source

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

Return the page’s <title> text.

§Errors

Source

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

Return the page’s full outer HTML.

§Errors

Source

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

lightweight NodeHandles backed by CDP RemoteObjectIds.

No HTML serialisation occurs — the browser’s in-memory DOM is queried directly over the CDP connection, eliminating the page.content() + scraper::Html::parse_document round-trip.

§Errors

BrowserError::Timeout if it exceeds cdp_timeout.

§Example

use stygian_browser::{BrowserPool, BrowserConfig, WaitUntil};
use std::time::Duration;

let pool = BrowserPool::new(BrowserConfig::default()).await?;
let handle = pool.acquire().await?;
let mut page = handle.browser().expect("valid browser").new_page().await?;
page.navigate("https://example.com", WaitUntil::DomContentLoaded, Duration::from_secs(30)).await?;
    let ux_type = node.attr("data-ux").await?;
    let text    = node.text_content().await?;
    println!("{ux_type:?}: {text}");

Source

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

Evaluate arbitrary JavaScript and return the result as T.

§Errors

deserialization error.

Source

pub async fn save_cookies(&self) -> Result<Vec<Cookie>>

§Errors

Source

pub async fn inject_cookies(&self, cookies: &[SessionCookie]) -> Result<()>

SessionSnapshot and without requiring a direct chromiumoxide dependency in calling code.

Individual cookie failures are logged as warnings and do not abort the remaining cookies.

§Errors

call exceeds cdp_timeout.

§Example

use stygian_browser::{BrowserPool, BrowserConfig};
use stygian_browser::session::SessionCookie;
use std::time::Duration;

let pool = BrowserPool::new(BrowserConfig::default()).await?;
let handle = pool.acquire().await?;
let page = handle.browser().expect("valid browser").new_page().await?;
let cookies = vec![SessionCookie {
    name: "session".to_string(),
    value: "abc123".to_string(),
    domain: ".example.com".to_string(),
    path: "/".to_string(),
    expires: -1.0,
    http_only: true,
    secure: true,
    same_site: "Lax".to_string(),
}];
page.inject_cookies(&cookies).await?;

Source

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

Capture a screenshot of the current page as PNG bytes.

them in-memory.

§Errors

command fails, or BrowserError::Timeout if it exceeds cdp_timeout.

§Example

use stygian_browser::{BrowserPool, BrowserConfig, WaitUntil};
use std::{time::Duration, fs};

let pool = BrowserPool::new(BrowserConfig::default()).await?;
let handle = pool.acquire().await?;
let mut page = handle.browser().expect("valid browser").new_page().await?;
let png = page.screenshot().await?;
fs::write("screenshot.png", &png).unwrap();

Source

pub const fn inner(&self) -> &Page

Borrow the underlying chromiumoxide Page.

Source

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

Close this page (tab).

Source §

impl PageHandle

Source

pub async fn verify_stealth(&self) -> Result<DiagnosticReport>

Run all built-in stealth detection checks against the current page.

Iterates crate::diagnostic::all_checks, evaluates each check’s JavaScript via CDP Runtime.evaluate, and returns an aggregate crate::diagnostic::DiagnosticReport.

recorded as failing checks and do not abort the whole run.

§Errors

Individual check failures are captured in the report.

§Example

use stygian_browser::{BrowserPool, BrowserConfig};
use stygian_browser::page::WaitUntil;
use std::time::Duration;

let pool = BrowserPool::new(BrowserConfig::default()).await?;
let handle = pool.acquire().await?;
let browser = handle.browser().expect("valid browser");
let mut page = browser.new_page().await?;
page.navigate("https://example.com", WaitUntil::DomContentLoaded, Duration::from_secs(10)).await?;

let report = page.verify_stealth().await?;
println!("Stealth: {}/{} checks passed", report.passed_count, report.checks.len());
    eprintln!("  FAIL  {}: {}", failure.description, failure.details);