Enum BrowserPoolError 

pub enum BrowserPoolError {
    BrowserCreation(String),
    HealthCheckFailed(String),
    ShuttingDown,
    Configuration(String),
}

Errors that can occur during browser pool operations.

This enum represents all possible error conditions when working with the browser pool. Each variant includes context about what went wrong.

Example

use html2pdf_api::BrowserPoolError;

fn handle_error(error: BrowserPoolError) {
    match error {
        BrowserPoolError::BrowserCreation(msg) => {
            eprintln!("Browser creation failed: {}", msg);
        }
        BrowserPoolError::HealthCheckFailed(msg) => {
            eprintln!("Health check failed: {}", msg);
        }
        BrowserPoolError::ShuttingDown => {
            eprintln!("Pool is shutting down");
        }
        BrowserPoolError::Configuration(msg) => {
            eprintln!("Configuration error: {}", msg);
        }
    }
}

Variants

BrowserCreation(String)

Failed to create a new browser instance.

This typically indicates Chrome/Chromium binary issues or launch flag problems.

Common Causes

• Chrome/Chromium binary not found or not installed
• Invalid Chrome binary path specified
• Insufficient permissions to execute Chrome
• Invalid or conflicting launch flags
• System resource limits exceeded (e.g., too many processes)

Example

use html2pdf_api::BrowserPoolError;

let error = BrowserPoolError::BrowserCreation(
    "Chrome binary not found".to_string()
);
println!("{}", error); // "Failed to create browser: Chrome binary not found"

HealthCheckFailed(String)

Browser failed a health check operation.

Triggered when ping operations (new_tab, navigate, close) fail.

Common Causes

• Browser process crashed unexpectedly
• Out of memory condition
• CDP (Chrome DevTools Protocol) connection lost
• Browser tab became unresponsive

Recovery

The pool automatically removes unhealthy browsers and creates replacements. Users typically don’t need to handle this error specially unless monitoring browser health.

Example

use html2pdf_api::BrowserPoolError;

let error = BrowserPoolError::HealthCheckFailed(
    "new_tab() failed: connection refused".to_string()
);
println!("{}", error); // "Browser health check failed: new_tab() failed: connection refused"

ShuttingDown

Operation attempted during pool shutdown.

All operations are rejected once shutdown begins.

This error is returned when:

• BrowserPool::shutdown() has been called
• BrowserPool::shutdown_async() has been called
• The BrowserPool is being dropped

Handling

This error typically occurs during application shutdown. Handle it gracefully by stopping any pending work rather than retrying.

Example

use html2pdf_api::BrowserPoolError;

let error = BrowserPoolError::ShuttingDown;
println!("{}", error); // "Pool is shutting down"

Configuration(String)

Invalid configuration provided.

This error occurs when pool configuration values are invalid.

Common Causes

• max_pool_size is set to 0
• warmup_count exceeds max_pool_size
• Invalid Chrome binary path
• Invalid duration values

Prevention

Use BrowserPoolConfigBuilder which validates configuration at build time.

Example

use html2pdf_api::BrowserPoolError;

let error = BrowserPoolError::Configuration(
    "max_pool_size must be greater than 0".to_string()
);
println!("{}", error); // "Configuration error: max_pool_size must be greater than 0"

Trait Implementations

impl Debug for BrowserPoolError

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

Formats the value using the given formatter.

impl Display for BrowserPoolError

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

Formats the value using the given formatter.

impl Error for BrowserPoolError

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<&str> for BrowserPoolError

Convenience conversion from &str to BrowserPoolError::Configuration.

Allows using string literals directly where BrowserPoolError is expected.

Example

use html2pdf_api::BrowserPoolError;

let error: BrowserPoolError = "invalid setting".into();
assert!(matches!(error, BrowserPoolError::Configuration(_)));

fn from(msg: &str) -> Self

Converts to this type from the input type.

impl From<String> for BrowserPoolError

Convenience conversion from String to BrowserPoolError::Configuration.

Allows using the ? operator with functions that return String errors in contexts expecting BrowserPoolError.

Example

use html2pdf_api::BrowserPoolError;

let error: BrowserPoolError = "invalid configuration".to_string().into();
assert!(matches!(error, BrowserPoolError::Configuration(_)));

fn from(msg: String) -> Self

Converts to this type from the input type.