Struct FirefoxBrowser 

pub struct FirefoxBrowser { /* private fields */ }

Implementations

impl FirefoxBrowser

pub async fn new(config: FirefoxConfig) -> FirefoxBrowser

pub async fn connect_bidi(&mut self)

pub fn get_config(&self) -> &FirefoxConfig

pub fn get_browser_process(&self) -> &Option<Process>

Trait Implementations

impl BidiBrowser for FirefoxBrowser

type Transport = WebsocketConnectionTransport

type BrowserNode = FirefoxNode<WebsocketConnectionTransport>

fn driver(&self) -> &BidiDriver<WebsocketConnectionTransport>

Access the underlying BiDi driver (immutable).

fn driver_mut(&mut self) -> &mut BidiDriver<WebsocketConnectionTransport>

Access the underlying BiDi driver (mutable).

fn build_node( &self, raw_node: NodeRemoteValue, locator: Locator, context: BrowsingContext, ) -> FirefoxNode<WebsocketConnectionTransport>

Construct a browser-specific node from raw BiDi data.

async fn close(self) -> Result<(), BrowserCloseError>

Closes the browser: ends the BiDi session, closes the WebSocket connection, and performs any browser-specific cleanup (e.g. kills the browser process).

fn navigate( &mut self, url: &str, ) -> impl Future<Output = Result<NavigateResult, NavigateError>> + Send

Navigates to the specified URL in the active context.

fn navigate_with_options( &mut self, url: &str, options: NavigateOptions, ) -> impl Future<Output = Result<NavigateResult, NavigateError>> + Send

Navigates to the specified URL with custom options (wait state, context).

fn close_context( &mut self, context: DomainBrowsingContext, ) -> impl Future<Output = Result<(), ContextCloseError>> + Send

Closes a browsing context (tab/window).

fn create_context( &mut self, background: bool, ) -> impl Future<Output = Result<DomainBrowsingContext, ContextCreationError>> + Send

Creates a new browsing context (tab) with default options.

fn create_context_with_options( &mut self, background: bool, options: CreateContextOptions, ) -> impl Future<Output = Result<DomainBrowsingContext, ContextCreationError>> + Send

Creates a new browsing context with custom options (type, reference context, background).

fn find_nodes( &mut self, locator: Locator, ) -> impl Future<Output = Result<Vec<Self::BrowserNode>, FindNodesError>> + Send

Finds all elements matching the given locator in the active context.

fn find_nodes_with_options( &mut self, locator: Locator, options: FindNodesOptions, ) -> impl Future<Output = Result<Vec<Self::BrowserNode>, FindNodesError>> + Send

Finds all elements matching the given locator with custom options (context, count, serialization, start nodes).

fn find_node( &mut self, locator: Locator, ) -> impl Future<Output = Result<Option<Self::BrowserNode>, FindNodesError>> + Send

Finds the first element matching the given locator in the active context.

fn find_node_with_options( &mut self, locator: Locator, options: FindNodesOptions, ) -> impl Future<Output = Result<Option<Self::BrowserNode>, FindNodesError>> + Send

Finds the first element matching the given locator with custom options.

fn wait_for_nodes( &mut self, locator: Locator, ) -> impl Future<Output = Result<Vec<Self::BrowserNode>, FindNodesError>> + Send

Waits for elements matching the locator to appear (default 4s timeout).

fn wait_for_nodes_with_options( &mut self, locator: Locator, options: WaitForNodesOptions, ) -> impl Future<Output = Result<Vec<Self::BrowserNode>, FindNodesError>> + Send

Waits for elements matching the locator with custom options (context, timeout, poll interval).

fn wait_for_node( &mut self, locator: Locator, ) -> impl Future<Output = Result<Option<Self::BrowserNode>, FindNodesError>> + Send

Waits for a single element matching the locator to appear (default 4s timeout).

fn wait_for_node_with_options( &mut self, locator: Locator, options: WaitForNodesOptions, ) -> impl Future<Output = Result<Option<Self::BrowserNode>, FindNodesError>> + Send

Waits for a single element matching the locator with custom options.

fn on_request<F, Fut>( &mut self, handler: F, ) -> impl Future<Output = Result<(), InterceptNetworkError>> + Send

where F: Fn(NetworkRequest<Self::Transport>) -> Fut + Send + Sync + 'static, Fut: Future<Output = ()> + Send + 'static,

Registers a handler called for each network request (all URLs, all contexts).

fn on_request_with_options<F, Fut>( &mut self, handler: F, options: OnRequestOptions, ) -> impl Future<Output = Result<(), InterceptNetworkError>> + Send

where F: Fn(NetworkRequest<Self::Transport>) -> Fut + Send + Sync + 'static, Fut: Future<Output = ()> + Send + 'static,

Registers a handler called for each network request with custom URL pattern and context filters.

fn subscribe_events<F, R>( &mut self, events: HashSet<&str>, handler: F, ) -> impl Future<Output = Result<Option<SubscribeResult>, CommandResultError>> + Send

where F: FnMut(Event) -> R + Send + Sync + 'static, R: Future<Output = ()> + Send + 'static,

Subscribes to browser events and registers a handler.

fn subscribe_events_with_options<F, R>( &mut self, events: HashSet<&str>, handler: F, options: SubscribeEventsOptions, ) -> impl Future<Output = Result<Option<SubscribeResult>, CommandResultError>> + Send

where F: FnMut(Event) -> R + Send + Sync + 'static, R: Future<Output = ()> + Send + 'static,

Subscribes to browser events with context and user context filters.

fn add_event_handler<F, R>( &mut self, events: HashSet<&str>, handler: F, ) -> impl Future<Output = String> + Send

where F: FnMut(Event) -> R + Send + Sync + 'static, R: Future<Output = ()> + Send + 'static,

Adds an event handler without sending a subscription command.

fn evaluate_script( &mut self, expression: String, await_promise: bool, ) -> impl Future<Output = Result<EvaluateResultSuccess, EvaluateResultError>> + Send

Evaluates a JavaScript expression in the active browsing context.

fn evaluate_script_with_options( &mut self, expression: String, await_promise: bool, options: EvaluateScriptOptions, ) -> impl Future<Output = Result<EvaluateResultSuccess, EvaluateResultError>> + Send

Evaluates a JavaScript expression with custom options (target, result ownership, serialization).

fn add_preload_script( &mut self, function_declaration: String, ) -> impl Future<Output = Result<String, EvaluateResultError>> + Send

Adds a preload script that runs in every new browsing context.

fn add_preload_script_with_options( &mut self, function_declaration: String, options: AddPreloadScriptOptions, ) -> impl Future<Output = Result<String, EvaluateResultError>> + Send

Adds a preload script with custom options (arguments, contexts, sandbox).

fn remove_preload_script( &mut self, script: String, ) -> impl Future<Output = Result<(), EvaluateResultError>> + Send

Removes a preload script by its ID.

fn screenshot( &mut self, ) -> impl Future<Output = Result<String, ScreenshotError>> + Send

Captures a screenshot of the active browsing context and returns base64-encoded image data.

fn screenshot_with_options( &mut self, options: BrowserScreenshotOptions, ) -> impl Future<Output = Result<String, ScreenshotError>> + Send

Captures a screenshot with custom options (context, origin, format, clip, save path).

fn emulate_timezone( &mut self, timezone: Option<String>, ) -> impl Future<Output = Result<(), EmulationError>> + Send

Emulates a timezone for the active browsing context.

fn emulate_timezone_with_options( &mut self, timezone: Option<String>, options: EmulateTimezoneOptions, ) -> impl Future<Output = Result<(), EmulationError>> + Send

Emulates a timezone with custom context and user context filters.

fn authenticate( &mut self, username: impl Into<String> + Send + 'static, password: impl Into<String> + Send + 'static, ) -> impl Future<Output = Result<(), InterceptNetworkError>> + Send

Sets HTTP authentication credentials for all requests.

fn authenticate_with_options( &mut self, username: impl Into<String> + Send + 'static, password: impl Into<String> + Send + 'static, options: AuthenticateOptions, ) -> impl Future<Output = Result<(), InterceptNetworkError>> + Send

Sets HTTP authentication credentials with URL pattern and context filters.

fn mouse(&self) -> &BidiMouse<Self::Transport>

Returns a reference to the direct BiDi mouse for precise, instant movements.

fn human_mouse(&self) -> &HumanMouse<BidiMouse<Self::Transport>>

Returns a reference to the human mouse for realistic, human-like movements with Bezier curves and jitter.

fn keyboard(&self) -> &BidiKeyboard<Self::Transport>

Returns a reference to the keyboard for text input and key presses.

fn touchscreen(&self) -> &Touchscreen<Self::Transport>

fn human_touchscreen(&self) -> &HumanTouchscreen<Self::Transport>

fn get_active_context_id(&self) -> Result<BrowsingContext, ContextIndexError>

fn send_command( &mut self, command: Command, ) -> impl Future<Output = Result<CommandResponse, SessionSendError>> + Send

Sends a raw WebDriver BiDi command.

fn end_session( &mut self, ) -> impl Future<Output = Result<(), SessionSendError>> + Send

Ends the BiDi session and cleans up resources.

impl Debug for FirefoxBrowser

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

Formats the value using the given formatter.