Struct Browser 

pub struct Browser { /* private fields */ }

A handle to a Chrome/Chromium browser instance.

Example

use ferrous_browser::{Browser, WaitUntil};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let browser = Browser::launch_chrome(None).await?;
    let page = browser.new_page().await?;
    page.goto("https://example.com", WaitUntil::Load).await?;
    Ok(())
}

Implementations

impl Browser

pub async fn launch_chrome(config: Option<BrowserConfig>) -> Result<Self>

Launch Chrome/Chromium and connect to it automatically.

Pass None to use BrowserConfig::default.

Example

use ferrous_browser::{Browser, BrowserConfig};

let browser = Browser::launch_chrome(None).await?;

let config = BrowserConfig { headless: false, ..Default::default() };
let browser = Browser::launch_chrome(Some(config)).await?;

pub async fn connect(ws_url: String) -> Result<Self>

Connect to a CDP WebSocket URL directly.

Example

use ferrous_browser::Browser;

let browser = Browser::connect("ws://localhost:9222".to_string()).await?;

pub async fn launch() -> Result<Self>

Connect to a Chrome instance already running on localhost:9222.

Example

use ferrous_browser::Browser;

let browser = Browser::launch().await?;

pub async fn new_page(&self) -> Result<Page>

Create a new page/tab in the browser.

pub async fn page_count(&self) -> usize

Get the number of open pages/tabs.

Trait Implementations

impl Drop for Browser

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.