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?;

pub async fn connect(ws_url: &str) -> Result<Browser, 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.

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.

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<(), Error>

Formats the value using the given formatter.

impl Drop for Browser

fn drop(&mut self)

Executes the destructor for this type.