Struct TestHarness 

pub struct TestHarness { /* private fields */ }

Test harness that manages browser, context, and page lifecycle.

The harness provides access to browser automation fixtures and handles cleanup automatically via Drop. It supports different scoping levels to balance test isolation against performance.

Scoping Levels

• TestHarness::new() - Test-scoped: new browser per test (default)
• TestHarness::from_browser() - Module-scoped: reuse browser, fresh context/page
• TestHarness::from_context() - Shared context: reuse context, fresh page only

Example

use viewpoint_test::TestHarness;

#[tokio::test]
async fn my_test() -> Result<(), Box<dyn std::error::Error>> {
    let harness = TestHarness::new().await?;
    let page = harness.page();

    page.goto("https://example.com").goto().await?;

    Ok(()) // harness drops and cleans up
}

Implementations

impl TestHarness

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

Create a new test harness with default configuration.

This creates a new browser, context, and page for the test. All resources are owned and will be cleaned up on drop.

Errors

Returns an error if browser launch or page creation fails.

pub async fn with_config(config: TestConfig) -> Result<Self, TestError>

Create a new test harness with custom configuration.

Errors

Returns an error if browser launch or page creation fails.

pub fn builder() -> TestHarnessBuilder

Create a test harness builder for custom configuration.

pub async fn from_browser(browser: &Browser) -> Result<Self, TestError>

Create a test harness using an existing browser.

This creates a new context and page in the provided browser. The browser will NOT be closed when the harness is dropped.

Errors

Returns an error if context or page creation fails.

pub async fn from_context(context: &BrowserContext) -> Result<Self, TestError>

Create a test harness using an existing context.

This creates a new page in the provided context. Neither the browser nor context will be closed when the harness is dropped.

Errors

Returns an error if page creation fails.

pub fn page(&self) -> &Page

Get a reference to the page.

pub fn page_mut(&mut self) -> &mut Page

Get a mutable reference to the page.

pub fn context(&self) -> Option<&BrowserContext>

Get a reference to the browser context.

Returns None if this harness was created with from_context().

pub fn browser(&self) -> Option<&Browser>

Get a reference to the browser.

Returns None if this harness was created with from_browser() or from_context().

pub fn config(&self) -> &TestConfig

Get the test configuration.

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

Create a new page in the same context.

Errors

Returns an error if page creation fails or if no context is available.

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

Explicitly close all owned resources.

This is called automatically on drop, but can be called explicitly to handle cleanup errors.

Errors

Returns an error if cleanup fails.

Trait Implementations

impl Debug for TestHarness

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

Formats the value using the given formatter.

impl Drop for TestHarness

fn drop(&mut self)

Executes the destructor for this type.