Struct SessionBuilder 

pub struct SessionBuilder<'a, C, B> { /* private fields */ }

A scoped, chainable builder for opening a thirtyfour Session against a running Chromedriver.

Obtained via Chromedriver::session. Optional setup steps:

• Self::with_caps mutates the ChromeCapabilities before the session opens (e.g. unset headless, add Chrome args).
• Self::with_config receives the WebDriverBuilder and may configure the element poller, request timeout, user-agent, or keep-alive flag.

Call Self::run to open the session and execute the user closure inside scoped, panic-safe cleanup that always calls WebDriver::quit().await.

Implementations

impl<'a, B> SessionBuilder<'a, DefaultCaps, B>

pub fn with_caps<F>(self, f: F) -> SessionBuilder<'a, CapsSetup<F>, B>

where F: FnOnce(&mut ChromeCapabilities) -> Result<(), WebDriverError>,

Provide a closure that mutates the ChromeCapabilities used to create the session.

impl<'a, C> SessionBuilder<'a, C, DefaultConfig>

pub fn with_config<F>(self, f: F) -> SessionBuilder<'a, C, ConfigSetup<F>>

where F: FnOnce(WebDriverBuilder) -> WebDriverBuilder,

Provide a closure that configures the WebDriverBuilder before the session is opened.

impl<C, B> SessionBuilder<'_, C, B>

where C: ApplyCaps, B: ApplyConfig,

pub async fn run<T, E, F>( self, f: F, ) -> Result<T, Report<ChromeForTestingManagerError>>

where F: for<'b> AsyncFnOnce(&'b Session) -> Result<T, E>, E: IntoReportCollection<SendSync>,

Open a Session, hand it to the user closure, and tear it down once the closure resolves or panics.

Cleanup runs regardless of outcome. A panic in the user closure is caught, the session is quit, and the panic is resumed afterwards.

Errors

Returns an error if capability setup, session creation, the user closure, or the quit call fails. A user error combined with a quit error is reported with the quit error attached as a child.