Struct BrowserPoolConfigBuilder 

pub struct BrowserPoolConfigBuilder { /* private fields */ }

Builder for BrowserPoolConfig with validation.

Provides a fluent API for constructing validated configurations. All setter methods can be chained together.

Example

use std::time::Duration;
use html2pdf_api::BrowserPoolConfigBuilder;

let config = BrowserPoolConfigBuilder::new()
    .max_pool_size(10)
    .warmup_count(5)
    .browser_ttl(Duration::from_secs(7200))
    .build()
    .expect("Invalid configuration");

Validation

The build() method validates:

• max_pool_size must be greater than 0
• warmup_count must be d max_pool_size

Implementations

impl BrowserPoolConfigBuilder

pub fn new() -> Self

Create a new builder with default values.

Example

use html2pdf_api::BrowserPoolConfigBuilder;

let builder = BrowserPoolConfigBuilder::new();
let config = builder.build().unwrap();

// Has default values
assert_eq!(config.max_pool_size, 5);

pub fn max_pool_size(self, size: usize) -> Self

Set maximum pool size (must be > 0).

Parameters

• size - Maximum number of browsers in the pool.

Example

use html2pdf_api::BrowserPoolConfigBuilder;

let config = BrowserPoolConfigBuilder::new()
    .max_pool_size(10)
    .build()
    .unwrap();

assert_eq!(config.max_pool_size, 10);

pub fn warmup_count(self, count: usize) -> Self

Set warmup count (must be d max_pool_size).

Parameters

• count - Number of browsers to pre-create during warmup.

Example

use html2pdf_api::BrowserPoolConfigBuilder;

let config = BrowserPoolConfigBuilder::new()
    .max_pool_size(10)
    .warmup_count(5)
    .build()
    .unwrap();

assert_eq!(config.warmup_count, 5);

pub fn ping_interval(self, interval: Duration) -> Self

Set health check interval.

Parameters

• interval - Duration between health check pings.

Example

use std::time::Duration;
use html2pdf_api::BrowserPoolConfigBuilder;

let config = BrowserPoolConfigBuilder::new()
    .ping_interval(Duration::from_secs(30))
    .build()
    .unwrap();

assert_eq!(config.ping_interval, Duration::from_secs(30));

pub fn browser_ttl(self, ttl: Duration) -> Self

Set browser time-to-live before forced retirement.

Parameters

• ttl - Maximum lifetime for each browser instance.

Example

use std::time::Duration;
use html2pdf_api::BrowserPoolConfigBuilder;

let config = BrowserPoolConfigBuilder::new()
    .browser_ttl(Duration::from_secs(7200)) // 2 hours
    .build()
    .unwrap();

assert_eq!(config.browser_ttl, Duration::from_secs(7200));

pub fn max_ping_failures(self, failures: u32) -> Self

Set maximum consecutive ping failures before removal.

Parameters

• failures - Number of consecutive failures tolerated.

Example

use html2pdf_api::BrowserPoolConfigBuilder;

let config = BrowserPoolConfigBuilder::new()
    .max_ping_failures(5)
    .build()
    .unwrap();

assert_eq!(config.max_ping_failures, 5);

pub fn warmup_timeout(self, timeout: Duration) -> Self

Set warmup timeout.

Parameters

• timeout - Maximum time allowed for warmup to complete.

Example

use std::time::Duration;
use html2pdf_api::BrowserPoolConfigBuilder;

let config = BrowserPoolConfigBuilder::new()
    .warmup_timeout(Duration::from_secs(120))
    .build()
    .unwrap();

assert_eq!(config.warmup_timeout, Duration::from_secs(120));

pub fn build(self) -> Result<BrowserPoolConfig, String>

Build and validate the configuration.

Errors

• Returns error if max_pool_size is 0
• Returns error if warmup_count > max_pool_size

Example

use html2pdf_api::BrowserPoolConfigBuilder;

// Valid configuration
let config = BrowserPoolConfigBuilder::new()
    .max_pool_size(10)
    .warmup_count(5)
    .build();
assert!(config.is_ok());

// Invalid: pool size is 0
let config = BrowserPoolConfigBuilder::new()
    .max_pool_size(0)
    .build();
assert!(config.is_err());

// Invalid: warmup exceeds pool size
let config = BrowserPoolConfigBuilder::new()
    .max_pool_size(5)
    .warmup_count(10)
    .build();
assert!(config.is_err());

Trait Implementations

impl Default for BrowserPoolConfigBuilder

fn default() -> Self

Returns the “default value” for a type.