Enum CdpError 

#[non_exhaustive]
pub enum CdpError {
    UnknownFakeUrl(String),
    ChromiumNotFound {
        install_hint: String,
    },
    UnsupportedChromium {
        min_supported: u32,
        max_supported: u32,
        found: u32,
    },
    MalformedSnapshot {
        reason: String,
    },
    InvalidCookie {
        field: &'static str,
        input: String,
        reason: &'static str,
    },
    InvalidHeader {
        field: &'static str,
        input: String,
        reason: &'static str,
    },
    InvalidPath {
        path: PathBuf,
        reason: String,
    },
    MalformedStorageState {
        path: PathBuf,
        reason: String,
    },
    Driver(Box<dyn Error + Send + Sync>),
    AutoFetchFailed {
        reason: String,
    },
    HashMismatch {
        path: PathBuf,
        expected: String,
        found: String,
    },
    CacheDirUnavailable {
        reason: String,
    },
}

Errors returned by drivers.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

UnknownFakeUrl(String)

An unknown URL scheme was passed to the fake driver.

ChromiumNotFound

No suitable Chromium or Chrome executable could be found.

Fields

install_hint: String

Human-readable installation and override guidance.

UnsupportedChromium

The Chromium binary reported a major version outside Plumb’s supported range.

Fields

min_supported: u32

Lowest validated major version (see MIN_SUPPORTED_CHROMIUM_MAJOR).

max_supported: u32

Highest tested major version (see MAX_SUPPORTED_CHROMIUM_MAJOR).

found: u32

Detected major version.

MalformedSnapshot

The DOMSnapshot CDP response was malformed (missing index, out-of-range string, empty document list, or any other shape violation that prevents safe flattening).

Fields

reason: String

What was wrong with the response.

InvalidCookie

A user-supplied cookie name/value contained illegal characters (header injection guard — newlines are refused before reaching the browser).

Fields

field: &'static str

Which cookie field failed validation (name or value).

input: String

The offending input.

reason: &'static str

Reason the input was rejected.

InvalidHeader

A user-supplied HTTP header name/value contained illegal characters (header injection guard — newlines and : in names are refused before reaching the browser).

Fields

field: &'static str

Which header field failed validation (name or value).

input: String

The offending input.

reason: &'static str

Reason the input was rejected.

InvalidPath

A user-supplied path (auth-script or storage-state) failed the safe-path check.

Fields

path: PathBuf

The offending path.

reason: String

Reason the path was rejected.

MalformedStorageState

Failed to parse a Playwright storage-state JSON file.

Fields

path: PathBuf

The file the driver was reading.

reason: String

What went wrong.

Driver(Box<dyn Error + Send + Sync>)

Any other driver-level failure, carried as a boxed std::error::Error.

AutoFetchFailed

Auto-fetch (--auto-fetch-chromium) failed to download or install Chromium. Wraps the upstream chromiumoxide fetcher failure in a typed Plumb error so the CLI can surface a single “auto-fetch could not produce a working binary” message.

Fields

reason: String

Human-readable reason (download / unzip / options error).

HashMismatch

A cached Chromium binary’s SHA-256 disagrees with the recorded .plumb-sha256 sidecar. Plumb refuses to launch the binary so a tampered cache cannot silently be promoted into an arbitrary-code-execution path.

Fields

path: PathBuf

Path of the offending binary.

expected: String

Hex SHA-256 from the sidecar (the value Plumb originally trusted).

found: String

Hex SHA-256 of the binary as it currently exists.

CacheDirUnavailable

Auto-fetch needs a platform cache directory, but the host environment did not provide enough information to resolve one (no HOME / LOCALAPPDATA / XDG_CACHE_HOME).

Fields

reason: String

Human-readable reason (which env var was missing).

Trait Implementations

impl Debug for CdpError

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

Formats the value using the given formatter.

impl Display for CdpError

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

Formats the value using the given formatter.

impl Error for CdpError

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.