Enum BrowserError 

pub enum BrowserError {
    Playwright(String),
    Navigation(String),
    Timeout(String),
    PagePool(String),
    Config(String),
    Other(String),
}

Errors that can occur during browser automation operations.

Each variant carries a human-readable message describing what went wrong. When you match on this enum, the variant tells you the category of failure so you can decide whether to retry, reconfigure, or bail out.

Variants

Playwright(String)

A Playwright driver or protocol error.

This variant is produced when the underlying Playwright Rust bindings return an error – for example, when the browser process crashes, a CDP message fails, or the driver cannot be started. It is also the target of the automatic From<playwright_rs::Error> conversion.

Navigation(String)

A page navigation failure.

Returned when page.goto() fails, the page content cannot be extracted after repeated retries, or the Cloudflare solver encounters an unrecoverable problem. Check the inner message for details about which URL or step failed.

Timeout(String)

An operation exceeded its deadline.

Typically raised when wait_for_selector does not find the expected element within timeout_ms. You can increase the timeout in [BrowserConfig] or the per-request [FetchParams] to give the page more time to render.

PagePool(String)

A page-pool capacity or lookup error.

Returned when you try to register more pages than max_pages allows, or when a page-index lookup fails. This usually means too many concurrent fetches are in flight for the configured pool size.

Config(String)

An invalid or inconsistent configuration value.

Raised during [BrowserConfig::validate] or [StealthConfig::validate] when a field is out of range (e.g. max_pages > 50), mutually exclusive options are both set (e.g. proxy and proxy_rotator), or a file path does not exist.

Other(String)

An uncategorised error.

Catch-all for errors that do not fit neatly into the other categories. Inspect the inner message for specifics.

Trait Implementations

impl Debug for BrowserError

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

Formats the value using the given formatter.

impl Display for BrowserError

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

Formats the value using the given formatter.

impl Error for BrowserError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for BrowserError

fn from(e: Error) -> Self

Converts to this type from the input type.