Struct PersistentBrowser 

pub struct PersistentBrowser { /* private fields */ }

A persistent Chromium browser kept warm across multiple snapshots.

Each PersistentBrowser::snapshot call creates a fresh incognito browser context (Target.createBrowserContext), opens a page in it, captures the snapshot, and disposes the context — so cookies, localStorage, and any other origin-scoped state from call N never leak into call N+1. The underlying Chromium process stays alive until PersistentBrowser::shutdown is called or the value is dropped.

Cheap to clone — clones share the same underlying browser via Arc. Implements BrowserDriver.

Implementations

impl PersistentBrowser

pub async fn launch(options: ChromiumOptions) -> Result<Self, CdpError>

Launch Chromium and validate its version.

Per-call viewport and DPR are applied via Emulation.setDeviceMetricsOverride inside Self::snapshot, so the launch-time defaults here are placeholders sized to a 1280×800 desktop window.

Errors

Returns CdpError::ChromiumNotFound when no Chromium binary can be located, CdpError::UnsupportedChromium when the detected Chromium reports a major version outside the supported range, or CdpError::Driver for any other launch failure.

pub async fn snapshot(&self, target: Target) -> Result<PlumbSnapshot, CdpError>

Snapshot a single target inside a fresh incognito browser context.

Errors

Returns the same error variants as ChromiumDriver::snapshot: CdpError::Driver for CDP failures and CdpError::MalformedSnapshot when the response cannot be flattened.

pub async fn shutdown(&self) -> Result<(), CdpError>

Gracefully close the underlying browser and abort the handler task.

Idempotent — safe to call more than once. The first call sends Browser.close over CDP and aborts the handler task; subsequent calls observe the absent handle and return Ok(()).

Errors

Currently never returns an error: cleanup failures are logged at debug and swallowed so callers can use shutdown as a best-effort hook on MCP exit. The signature retains Result for forward-compatibility.

Trait Implementations

impl BrowserDriver for PersistentBrowser

async fn snapshot(&self, target: Target) -> Result<PlumbSnapshot, CdpError>

Snapshot a single target.

fn snapshot_all( &self, targets: Vec<Target>, ) -> impl Future<Output = Result<Vec<PlumbSnapshot>, CdpError>> + Send

Snapshot a list of targets, reusing a single browser session for the whole batch. The default implementation calls snapshot per target and is suitable for cheap drivers (e.g. FakeDriver). Real drivers MUST override this to launch the browser exactly once per batch.

impl Clone for PersistentBrowser

fn clone(&self) -> PersistentBrowser

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PersistentBrowser

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

Formats the value using the given formatter.