Struct ChromeBrowserFactory 

pub struct ChromeBrowserFactory { /* private fields */ }

Factory for creating Chrome/Chromium browser instances.

Handles Chrome-specific launch options and path detection. Supports both auto-detection and custom Chrome binary paths.

Thread Safety

This factory is Send + Sync and can be safely shared across threads.

Example

use html2pdf_api::ChromeBrowserFactory;

// Auto-detect Chrome
let factory = ChromeBrowserFactory::with_defaults();

// Or use custom path
let factory = ChromeBrowserFactory::with_path("/usr/bin/google-chrome".to_string());

Implementations

impl ChromeBrowserFactory

pub fn new<F>(launch_options_fn: F) -> Self

where F: Fn() -> Result<LaunchOptions<'static>> + Send + Sync + 'static,

Create factory with custom launch options function.

This is the most flexible constructor, allowing full control over launch options generation.

Parameters

• launch_options_fn - Function called for each browser creation.

Example

use html2pdf_api::{ChromeBrowserFactory, create_chrome_options, BrowserPoolError};

let factory = ChromeBrowserFactory::new(|| {
    // Custom logic here
    create_chrome_options(Some("/custom/path"))
        .map_err(|e| BrowserPoolError::Configuration(e.to_string()))
});

pub fn with_defaults() -> Self

Create factory with auto-detected Chrome path.

This is the recommended default - lets headless_chrome find Chrome. Works on Linux, macOS, and Windows.

Platform Detection

The headless_chrome crate searches common installation paths:

Platform	Paths Searched
Linux	/usr/bin/google-chrome, /usr/bin/chromium, etc.
macOS	/Applications/Google Chrome.app/...
Windows	C:\Program Files\Google\Chrome\...

Example

use html2pdf_api::ChromeBrowserFactory;

let factory = ChromeBrowserFactory::with_defaults();

pub fn with_path(chrome_path: String) -> Self

Create factory with custom Chrome binary path.

Use this when Chrome is installed in a non-standard location.

Parameters

• chrome_path - Full path to Chrome/Chromium binary.

Example

use html2pdf_api::ChromeBrowserFactory;

// Linux
let factory = ChromeBrowserFactory::with_path("/usr/bin/google-chrome".to_string());

// macOS
let factory = ChromeBrowserFactory::with_path(
    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome".to_string()
);

// Windows
let factory = ChromeBrowserFactory::with_path(
    r"C:\Program Files\Google\Chrome\Application\chrome.exe".to_string()
);

Trait Implementations

impl BrowserFactory for ChromeBrowserFactory

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

Create a new Chrome browser instance.

Calls the launch options function and launches Chrome with those options.

Errors

• Returns BrowserPoolError::Configuration if launch options generation fails.
• Returns BrowserPoolError::BrowserCreation if Chrome fails to launch.