Struct NewContextBuilder 

pub struct NewContextBuilder<'a> { /* private fields */ }

Builder for creating a new browser context with options.

Implementations

impl<'a> NewContextBuilder<'a>

pub fn storage_state_path(self, path: impl Into<PathBuf>) -> Self

Set storage state from a file path.

pub fn storage_state(self, state: StorageState) -> Self

Set storage state from an object.

pub fn geolocation(self, latitude: f64, longitude: f64) -> Self

Set geolocation.

pub fn geolocation_with_accuracy( self, latitude: f64, longitude: f64, accuracy: f64, ) -> Self

Set geolocation with accuracy.

pub fn permissions(self, permissions: Vec<Permission>) -> Self

Grant permissions.

pub fn http_credentials( self, username: impl Into<String>, password: impl Into<String>, ) -> Self

Set HTTP credentials.

pub fn extra_http_headers(self, headers: HashMap<String, String>) -> Self

Set extra HTTP headers.

pub fn header(self, name: impl Into<String>, value: impl Into<String>) -> Self

Add an extra HTTP header.

pub fn offline(self, offline: bool) -> Self

Set offline mode.

pub fn default_timeout(self, timeout: Duration) -> Self

Set default timeout.

pub fn default_navigation_timeout(self, timeout: Duration) -> Self

Set default navigation timeout.

pub fn has_touch(self, has_touch: bool) -> Self

Enable touch emulation.

pub fn locale(self, locale: impl Into<String>) -> Self

Set locale.

pub fn timezone_id(self, timezone_id: impl Into<String>) -> Self

Set timezone.

pub fn user_agent(self, user_agent: impl Into<String>) -> Self

Set user agent.

pub fn viewport(self, width: i32, height: i32) -> Self

Set viewport size.

pub fn color_scheme(self, color_scheme: ColorScheme) -> Self

Set color scheme.

pub fn reduced_motion(self, reduced_motion: ReducedMotion) -> Self

Set reduced motion preference.

pub fn forced_colors(self, forced_colors: ForcedColors) -> Self

Set forced colors preference.

pub fn device_scale_factor(self, scale_factor: f64) -> Self

Set device scale factor (device pixel ratio).

pub fn is_mobile(self, is_mobile: bool) -> Self

Set mobile mode.

pub fn device(self, device: DeviceDescriptor) -> Self

Apply a device descriptor to configure the context.

This sets viewport, user agent, device scale factor, touch, and mobile mode based on the device descriptor.

Example

use viewpoint_core::{Browser, devices};

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

let context = browser.new_context_builder()
    .device(devices::IPHONE_13)
    .build()
    .await?;

pub fn record_video(self, options: VideoOptions) -> Self

Enable video recording for pages in this context.

Videos are recorded for each page and saved to the specified directory.

Example

use viewpoint_core::{Browser, VideoOptions};

let browser = Browser::launch().headless(true).launch().await?;
let context = browser.new_context_builder()
    .record_video(VideoOptions::new("./videos"))
    .build()
    .await?;

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

Build and create the browser context.

Errors

Returns an error if context creation fails.

Trait Implementations

impl<'a> Debug for NewContextBuilder<'a>

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

Formats the value using the given formatter.