Enum Error 

pub enum Error {
    ServerNotFound,
    LaunchFailed(String),
    ServerError(String),
    BrowserNotInstalled {
        browser_name: String,
        message: String,
        playwright_version: String,
    },
    ConnectionFailed(String),
    TransportError(String),
    ProtocolError(String),
    Io(Error),
    Json(Error),
    Timeout(String),
    NavigationTimeout {
        url: String,
        duration_ms: u64,
    },
    TargetClosed {
        target_type: String,
        context: String,
    },
    UnknownObjectType(String),
    ChannelClosed,
    InvalidArgument(String),
    ElementNotFound(String),
    AssertionTimeout(String),
    ObjectNotFound(String),
    InvalidPath(String),
    Context(String, Box<Error>),
}

Errors that can occur when using playwright-core

Variants

ServerNotFound

Playwright server binary was not found

The Playwright Node.js driver could not be located. To resolve this, install Playwright using: npm install playwright Or ensure the PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD environment variable is not set.

LaunchFailed(String)

Failed to launch the Playwright server process

The Playwright server process could not be started. Common causes: Node.js not installed, insufficient permissions, or port already in use. Details: {0}

ServerError(String)

Server error (runtime issue with Playwright server)

BrowserNotInstalled

Browser is not installed

The specified browser has not been installed using Playwright’s installation command. To resolve this, install browsers using the versioned install command to ensure compatibility.

Fields

browser_name: String

message: String

playwright_version: String

ConnectionFailed(String)

Failed to establish connection with the server

TransportError(String)

Transport-level error (stdio communication)

ProtocolError(String)

Protocol-level error (JSON-RPC)

Io(Error)

I/O error

Json(Error)

JSON serialization/deserialization error

Timeout(String)

Timeout waiting for operation

Contains context about what operation timed out and the timeout duration. Common causes include slow network, server not responding, or element not becoming actionable. Consider increasing the timeout or checking if the target is accessible.

NavigationTimeout

Navigation timeout

Occurs when page navigation exceeds the specified timeout. Includes the URL being navigated to and timeout duration.

Fields

url: String

duration_ms: u64

TargetClosed

Target was closed (browser, context, or page)

Occurs when attempting to perform an operation on a closed target. The target must be recreated before it can be used again.

Fields

target_type: String

context: String

UnknownObjectType(String)

Unknown protocol object type

ChannelClosed

Channel closed unexpectedly

InvalidArgument(String)

Invalid argument provided to method

ElementNotFound(String)

Element not found by selector

Includes the selector that was used to locate the element. This error typically occurs when waiting for an element times out.

AssertionTimeout(String)

Assertion timeout (expect API)

ObjectNotFound(String)

Object not found in registry (may have been closed/disposed)

InvalidPath(String)

Invalid path provided

Context(String, Box<Error>)

Error with additional context

Implementations

impl Error

pub fn context(self, msg: impl Into<String>) -> Self

Adds context to the error

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.