Struct Browser 

pub struct Browser { /* private fields */ }

A browser instance connected via CDP.

Implementations

impl Browser

pub fn launch() -> BrowserBuilder

Create a browser builder for launching a new browser.

Example

use viewpoint_core::Browser;

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

Examples found in repository

examples/basic_navigation.rs (line 23)

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("Launching browser...");

    // Launch a headless browser
    let browser = Browser::launch()
        .headless(true)
        .timeout(Duration::from_secs(30))
        .launch()
        .await?;

    println!("Browser launched successfully!");

    // Create a new browser context (isolated environment)
    let context = browser.new_context().await?;
    println!("Created browser context: {}", context.id());

    // Create a new page
    let page = context.new_page().await?;
    println!("Created page with target: {}", page.target_id());

    // Navigate to a URL with default wait (Load event)
    println!("\nNavigating to example.com...");
    let response = page.goto("https://example.com").goto().await?;
    println!("Navigation complete! URL: {}", response.url());

    // Navigate with DomContentLoaded wait (faster)
    println!("\nNavigating to httpbin.org with DomContentLoaded wait...");
    let response = page
        .goto("https://httpbin.org/html")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .timeout(Duration::from_secs(15))
        .goto()
        .await?;
    println!("Navigation complete! URL: {}", response.url());

    // Navigate with custom referer
    println!("\nNavigating with custom referer...");
    let response = page
        .goto("https://httpbin.org/headers")
        .referer("https://google.com")
        .wait_until(DocumentLoadState::Load)
        .goto()
        .await?;
    println!("Navigation complete! URL: {}", response.url());

    // Close the browser
    println!("\nClosing browser...");
    browser.close().await?;
    println!("Done!");

    Ok(())
}

pub async fn connect(ws_url: &str) -> Result<Self, BrowserError>

Connect to an already-running browser via WebSocket URL.

Example

use viewpoint_core::Browser;

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

Errors

Returns an error if the connection fails.

pub async fn new_context(&self) -> Result<BrowserContext, BrowserError>

Create a new isolated browser context.

Browser contexts are isolated environments within the browser, similar to incognito windows. They have their own cookies, cache, and storage.

Errors

Returns an error if context creation fails.

Examples found in repository

examples/basic_navigation.rs (line 32)

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("Launching browser...");

    // Launch a headless browser
    let browser = Browser::launch()
        .headless(true)
        .timeout(Duration::from_secs(30))
        .launch()
        .await?;

    println!("Browser launched successfully!");

    // Create a new browser context (isolated environment)
    let context = browser.new_context().await?;
    println!("Created browser context: {}", context.id());

    // Create a new page
    let page = context.new_page().await?;
    println!("Created page with target: {}", page.target_id());

    // Navigate to a URL with default wait (Load event)
    println!("\nNavigating to example.com...");
    let response = page.goto("https://example.com").goto().await?;
    println!("Navigation complete! URL: {}", response.url());

    // Navigate with DomContentLoaded wait (faster)
    println!("\nNavigating to httpbin.org with DomContentLoaded wait...");
    let response = page
        .goto("https://httpbin.org/html")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .timeout(Duration::from_secs(15))
        .goto()
        .await?;
    println!("Navigation complete! URL: {}", response.url());

    // Navigate with custom referer
    println!("\nNavigating with custom referer...");
    let response = page
        .goto("https://httpbin.org/headers")
        .referer("https://google.com")
        .wait_until(DocumentLoadState::Load)
        .goto()
        .await?;
    println!("Navigation complete! URL: {}", response.url());

    // Close the browser
    println!("\nClosing browser...");
    browser.close().await?;
    println!("Done!");

    Ok(())
}

pub fn new_context_builder(&self) -> NewContextBuilder<'_>

Create a new context options builder.

Use this to create a browser context with custom configuration.

Example

use viewpoint_core::{Browser, Permission};

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

let context = browser.new_context_builder()
    .geolocation(37.7749, -122.4194)
    .permissions(vec![Permission::Geolocation])
    .offline(false)
    .build()
    .await?;

pub async fn new_context_with_options( &self, options: ContextOptions, ) -> Result<BrowserContext, BrowserError>

Create a new isolated browser context with options.

Errors

Returns an error if context creation fails.

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

Close the browser.

If this browser was launched by us, the process will be terminated. If it was connected to, only the WebSocket connection is closed.

Errors

Returns an error if closing fails.

Examples found in repository

examples/basic_navigation.rs (line 66)

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("Launching browser...");

    // Launch a headless browser
    let browser = Browser::launch()
        .headless(true)
        .timeout(Duration::from_secs(30))
        .launch()
        .await?;

    println!("Browser launched successfully!");

    // Create a new browser context (isolated environment)
    let context = browser.new_context().await?;
    println!("Created browser context: {}", context.id());

    // Create a new page
    let page = context.new_page().await?;
    println!("Created page with target: {}", page.target_id());

    // Navigate to a URL with default wait (Load event)
    println!("\nNavigating to example.com...");
    let response = page.goto("https://example.com").goto().await?;
    println!("Navigation complete! URL: {}", response.url());

    // Navigate with DomContentLoaded wait (faster)
    println!("\nNavigating to httpbin.org with DomContentLoaded wait...");
    let response = page
        .goto("https://httpbin.org/html")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .timeout(Duration::from_secs(15))
        .goto()
        .await?;
    println!("Navigation complete! URL: {}", response.url());

    // Navigate with custom referer
    println!("\nNavigating with custom referer...");
    let response = page
        .goto("https://httpbin.org/headers")
        .referer("https://google.com")
        .wait_until(DocumentLoadState::Load)
        .goto()
        .await?;
    println!("Navigation complete! URL: {}", response.url());

    // Close the browser
    println!("\nClosing browser...");
    browser.close().await?;
    println!("Done!");

    Ok(())
}

pub fn connection(&self) -> &Arc<CdpConnection>

Get a reference to the CDP connection.

pub fn is_owned(&self) -> bool

Check if this browser was launched by us.

Trait Implementations

impl Debug for Browser

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

Formats the value using the given formatter.

impl Drop for Browser

fn drop(&mut self)

Executes the destructor for this type.