Struct Session 

pub struct Session { /* private fields */ }

High-level CDP session. Manages connection + tabs with event-driven lifecycle.

Implementations

impl Session

pub async fn connect(ws_url: &str) -> Result<Self>

Connect to browser via WebSocket URL

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

Create a new tab/page

pub async fn evaluate(&self, tab: &Tab, js: &str) -> Result<Value>

Evaluate JavaScript in a tab, return JSON result

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

Navigate to URL and wait for networkIdle lifecycle event

pub async fn check_page_signals(&self, tab: &Tab) -> Result<Vec<QualityFlag>>

Runs a compact JS snippet in the page to detect quality issues before extraction. The JS snippet checks for Cloudflare/Turnstile bot walls, reCAPTCHA/hCaptcha, and paywall text markers. Keep JS logic in sync with Session::parse_signal_flags and gthings_extraction::quality::detection.

pub async fn wait_for<F>( &self, method: &str, predicate: F, timeout: Duration, ) -> Result<CdpEvent>

where F: Fn(&CdpEvent) -> bool + Send + 'static,

Wait for a CDP event matching method + predicate.

Warning: Creates a new event subscription. Subscribe BEFORE the action that triggers the event to avoid race conditions. For navigation, use navigate() instead.

pub async fn close_tab(&self, tab: Tab) -> Result<()>

Close a tab

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

Disconnect from browser

pub fn connection(&self) -> &Connection

Access the underlying Connection (for direct CDP calls)

Trait Implementations

impl Debug for Session

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

Formats the value using the given formatter.