Struct Tab 

pub struct Tab { /* private fields */ }

Represents a CDP browser tab (target) session.

Implementations

impl Tab

pub async fn set_viewport(&self, viewport: &Viewport) -> Result<&Self>

Sets the viewport size and device scale factor.

This is similar to Puppeteer’s page.setViewport() and is essential for getting higher resolution screenshots via deviceScaleFactor.

Example

let viewport = Viewport::new(1920, 1080)
    .with_device_scale_factor(2.0);  // 2x resolution for sharper images

tab.set_viewport(&viewport).await?;

pub async fn clear_viewport(&self) -> Result<&Self>

Clears the viewport override, returning to default browser behavior.

pub async fn set_content(&self, content: &str) -> Result<&Self>

Sets HTML content and waits for the “load” event.

pub async fn evaluate(&self, expression: &str) -> Result<Value>

Evaluates JavaScript in the page context and returns the result.

Example

let result = tab.evaluate("document.title").await?;
println!("Page title: {}", result);

pub async fn evaluate_as_string(&self, expression: &str) -> Result<String>

Evaluates JavaScript and returns the result as a string.

pub async fn find_element(&self, selector: &str) -> Result<Element<'_>>

Finds the first element matching the given CSS selector.

pub async fn wait_for_selector( &self, selector: &str, timeout_ms: u64, ) -> Result<Element<'_>>

Waits for an element matching the selector to appear in the DOM.

Arguments

• selector - CSS selector to wait for
• timeout_ms - Maximum time to wait in milliseconds

pub async fn screenshot(&self, opts: CaptureOptions) -> Result<String>

Captures a screenshot of the entire page.

Example

let options = CaptureOptions::new()
    .with_format(ImageFormat::Png)
    .with_viewport(Viewport::new(1920, 1080).with_device_scale_factor(2.0));

let base64_image = tab.screenshot(options).await?;

pub async fn activate(&self) -> Result<&Self>

Activates the target tab to bring it to the foreground.

pub async fn goto(&self, url: &str) -> Result<&Self>

Navigates the tab to the specified URL and waits for load.

pub async fn goto_no_wait(&self, url: &str) -> Result<&Self>

Navigates to URL without waiting for load event.

pub async fn reload(&self) -> Result<&Self>

Reloads the current page.

pub async fn url(&self) -> Result<String>

Gets the current URL of the page.

pub async fn title(&self) -> Result<String>

Gets the page title.

pub fn session_id(&self) -> &str

Returns the session ID for this tab.

pub fn target_id(&self) -> &str

Returns the target ID for this tab.

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

Closes the target tab.