Struct Window 

pub struct Window { /* private fields */ }

A handle to a Firefox browser window.

The window owns a Firefox process and profile, and holds a reference to the shared ConnectionPool for WebSocket communication. When dropped, the process is automatically killed.

Example

let window = driver.window().headless().spawn().await?;

// Get the initial tab
let tab = window.tab();

// Create a new tab
let new_tab = window.new_tab().await?;

// Close the window
window.close().await?;

Implementations

impl Window

pub fn session_id(&self) -> SessionId

Returns the session ID.

pub fn uuid(&self) -> &Uuid

Returns the Rust-side unique UUID.

pub fn port(&self) -> u16

Returns the WebSocket port (shared across all windows).

pub fn pid(&self) -> u32

Returns the Firefox process ID.

impl Window

pub async fn close(&self) -> Result<()>

Closes the window and kills the Firefox process.

Errors

Returns an error if the process cannot be killed.

impl Window

pub fn tab(&self) -> Tab

Returns the initial tab for this window.

pub async fn new_tab(&self) -> Result<Tab>

Creates a new tab in this window.

Errors

Returns an error if tab creation fails.

pub fn tab_count(&self) -> usize

Returns the number of tabs in this window.

pub async fn steal_logs(&self) -> Result<Vec<Value>>

Steals logs from extension (returns and clears).

Useful for debugging extension issues.

impl Window

pub async fn set_proxy(&self, config: ProxyConfig) -> Result<()>

Sets a proxy for all tabs in this window.

Window-level proxy applies to all tabs unless overridden by tab-level proxy.

Example

use firefox_webdriver::ProxyConfig;

// HTTP proxy for all tabs
window.set_proxy(ProxyConfig::http("proxy.example.com", 8080)).await?;

// SOCKS5 proxy with auth
window.set_proxy(
    ProxyConfig::socks5("proxy.example.com", 1080)
        .with_credentials("user", "pass")
        .with_proxy_dns(true)
).await?;

pub async fn clear_proxy(&self) -> Result<()>

Clears the proxy for this window.

After clearing, all tabs use direct connection (unless they have tab-level proxy).

Trait Implementations

impl Clone for Window

fn clone(&self) -> Window

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Window

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

Formats the value using the given formatter.