Struct BrowserType 

pub struct BrowserType { /* private fields */ }

Playwright-shaped browser factory. Construct via chromium / firefox / webkit (top-level free functions in this crate) or BrowserType::chromium_with for the Chromium transport override.

Copy because the type is just two enum tags — keeping it copy lets callers write chromium().launch(opts) without having to bind the factory to a let first when reusing it across multiple launches.

Implementations

impl BrowserType

pub fn chromium() -> Self

Construct a Chromium BrowserType. Equivalent to the top-level chromium function. Defaults to the CDP-pipe transport.

pub fn chromium_with(opts: &BrowserTypeOptions) -> Self

Construct a Chromium BrowserType with explicit BrowserTypeOptions. transport: Some(Ws) switches to the CDP-over-WebSocket backend (CdpRaw) instead of the pipe default.

pub fn firefox() -> Self

Construct a Firefox BrowserType. Equivalent to the top-level firefox function.

pub fn webkit() -> Self

Construct a WebKit BrowserType. Equivalent to the top-level webkit function. Only meaningfully usable on macOS — the Self::launch path returns a typed error elsewhere.

pub fn with_backend(kind: BrowserKind, backend: BackendKind) -> Self

Rust-only escape hatch used by the test runner to pin both the product and the wire backend explicitly. NOT exposed in the JS bindings — it’s intended for the test scaffolding that needs to hold BrowserKind::Chromium + BackendKind::CdpRaw (etc.) without going through chromium_with({ transport: Ws }).

pub fn name(self) -> &'static str

Playwright BrowserType.name() — "chromium" / "firefox" / "webkit".

pub fn kind(self) -> BrowserKind

Underlying BrowserKind.

pub fn executable_path(self) -> Option<PathBuf>

Path where ferridriver expects to find a bundled browser executable. Mirrors Playwright’s BrowserType.executablePath(). Returns None if no bundled binary is available for this product on the current platform.

pub async fn launch(self, options: LaunchOptions) -> Result<Browser>

Playwright: browserType.launch(options?) -> Browser.

Errors

Returns an error if the browser process fails to start.

pub async fn connect( self, ws_endpoint: &str, options: ConnectOptions, ) -> Result<Browser>

Playwright: browserType.connect(wsEndpoint, options?) -> Browser.

ferridriver currently has no Playwright-server protocol of its own; this accepts a CDP WebSocket endpoint and behaves like Self::connect_over_cdp under the hood. Kept as a separate method for surface parity with Playwright.

Errors

Returns an error if the WebSocket handshake fails.

pub async fn connect_over_cdp( self, endpoint_url: &str, _options: ConnectOverCdpOptions, ) -> Result<Browser>

Playwright: browserType.connectOverCDP(endpointURL, options?) -> Browser. Chromium-only.

Errors

Returns an error if the WebSocket handshake fails or the product is not Chromium.

pub async fn launch_persistent_context( &self, user_data_dir: &Path, options: LaunchPersistentContextOptions, ) -> Result<ContextRef>

Playwright: browserType.launchPersistentContext(userDataDir, options?) -> BrowserContext. Launches a browser whose default context shares storage with the supplied user-data directory and applies the provided BrowserContextOptions to that default context. Returns the default ContextRef; closing the returned context (or the underlying browser) terminates the launch.

Errors

Returns an error if the browser process fails to start.

Trait Implementations

impl Clone for BrowserType

fn clone(&self) -> BrowserType

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BrowserType

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

Formats the value using the given formatter.

impl Copy for BrowserType