Struct Browser 

pub struct Browser { /* private fields */ }

A browser instance.

Implementations

impl Browser

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

Create a new browser instance with default configuration (headless).

Example

use cdp_html_shot::Browser;
use anyhow::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let browser = Browser::new().await?;
    Ok(())
}

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

Create a new browser instance with a visible window.

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

Create a new tab.

Example

use cdp_html_shot::Browser;
use anyhow::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let browser = Browser::new().await?;
    let tab = browser.new_tab().await?;
    Ok(())
}

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

Close the initial tab created when the browser starts.

Warning

Only in headless mode, otherwise it will close the entire browser.

pub async fn capture_html(&self, html: &str, selector: &str) -> Result<String>

Basic version: Capture a screenshot of an HTML element.

Returns the base64-encoded image data (JPEG format).

If you need more control over the capture process, use capture_html_with_options.

Arguments

• html: The HTML content
• selector: The CSS selector of the element to capture

Example

use cdp_html_shot::Browser;
use anyhow::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let browser = Browser::new().await?;
    let base64 = browser.capture_html("<h1>Hello world!</h1>", "h1").await?;
    Ok(())
}

pub async fn capture_html_with_options( &self, html: &str, selector: &str, options: CaptureOptions, ) -> Result<String>

Advanced version: Capture a screenshot of an HTML element with additional options.

Arguments

• html: The HTML content
• selector: The CSS selector of the element to capture
• options: Configuration options for the capture

Example

use cdp_html_shot::{Browser, CaptureOptions};
use anyhow::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let browser = Browser::new().await?;
    let options = CaptureOptions::new()
        .with_raw_png(true);

    let base64 = browser
        .capture_html_with_options(
            "<h1>Hello world!</h1>",
            "h1",
            options
        ).await?;
    Ok(())
}

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

Close the browser.

This will kill the browser process and clean up temporary files.

Normally, this method does not need to be called manually, because it will be called automatically when the Browser instance is destroyed.

Example

use cdp_html_shot::Browser;
use anyhow::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let mut browser = Browser::new().await?;
    browser.close()?;
    Ok(())
}

impl Browser

pub async fn instance() -> Arc<Browser>

Get the global Browser instance.

Creates a new one if it doesn’t exist.

This method is thread-safe and ensures only one browser instance is created.

The browser will be automatically closed when all references are dropped or when the program exits.

Example

use cdp_html_shot::Browser;
use anyhow::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let browser = Browser::instance().await;
    let tab = browser.new_tab().await?;

    Browser::close_instance();
    Ok(())
}

pub fn close_instance() -> Option<()>

Close the global Browser instance.

Please ensure that this method is called before the program exits, and there should be no Browser instances in use at this time.

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.

impl Send for Browser

impl Sync for Browser