Struct MockBrowserFactory 

pub struct MockBrowserFactory { /* private fields */ }

Mock browser factory for testing without Chrome.

This factory can be configured to:

• Always succeed (creates real browsers if Chrome available)
• Always fail with a specific error
• Fail after N successful creations
• Track creation count for verification

Thread Safety

This factory is Send + Sync and tracks state using atomic operations.

Example

use html2pdf_api::factory::mock::MockBrowserFactory;

// Create a factory that always fails
let factory = MockBrowserFactory::always_fails("Test error");
assert!(factory.create().is_err());
assert_eq!(factory.creation_count(), 1);

// Create a factory that fails after 2 successful creations
let factory = MockBrowserFactory::fail_after_n(2, "Exhausted");

Implementations

impl MockBrowserFactory

pub fn new() -> Self

Create a mock factory that attempts real browser creation.

Note: This still requires Chrome to be installed to actually create browsers. For pure mocking without Chrome, use always_fails.

Example

let factory = MockBrowserFactory::new();
// Will attempt real browser creation
let result = factory.create();

pub fn always_fails<S: Into<String>>(message: S) -> Self

Create a mock factory that always fails with the given message.

This is useful for testing error handling paths without requiring Chrome to be installed.

Parameters

• message - Error message to return on creation attempts.

Example

let factory = MockBrowserFactory::always_fails("Chrome not installed");
let result = factory.create();
assert!(result.is_err());

pub fn fail_after_n<S: Into<String>>(n: usize, message: S) -> Self

Create a mock factory that fails after N successful creations.

Useful for testing pool behavior when browsers start failing after some have been successfully created (e.g., resource exhaustion).

Parameters

• n - Number of successful creations before failing.
• message - Error message after failures begin.

Example

let factory = MockBrowserFactory::fail_after_n(3, "Resource exhausted");
// First 3 calls may succeed (if Chrome installed), subsequent calls fail

pub fn creation_count(&self) -> usize

Get the number of browser creation attempts by this factory.

Useful for verifying pool behavior in tests.

Example

let factory = MockBrowserFactory::always_fails("test");
assert_eq!(factory.creation_count(), 0);
let _ = factory.create();
assert_eq!(factory.creation_count(), 1);

pub fn reset_count(&self)

Reset the creation counter to zero.

Useful when reusing a factory across multiple tests.

pub fn counter(&self) -> Arc<AtomicUsize>

Get a clone of the creation counter for external tracking.

This allows test code to monitor creation count even after the factory has been moved into a pool.

Example

let factory = MockBrowserFactory::new();
let counter = factory.counter();

// Move factory into pool
let pool = BrowserPool::builder()
    .factory(Box::new(factory))
    .build()?;

// Can still check count via cloned counter
println!("Created: {}", counter.load(Ordering::SeqCst));

Trait Implementations

impl BrowserFactory for MockBrowserFactory

fn create(&self) -> Result<Browser>

Create a browser or return a mock error.

Behavior depends on factory configuration:

• If should_fail is true, always returns error
• If fail_after is set and count exceeded, returns error
• Otherwise, attempts real browser creation

Errors

Returns BrowserPoolError::BrowserCreation when configured to fail.

impl Debug for MockBrowserFactory

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

Formats the value using the given formatter.

impl Default for MockBrowserFactory

fn default() -> Self

Returns the “default value” for a type.