Struct TabGuard 

pub struct TabGuard { /* private fields */ }

RAII wrapper around Box<dyn BrowserTab>.

Leak Prevention

If dropped without calling close or into_inner, a tracing::warn is emitted. Since Rust’s Drop cannot be async, the tab itself cannot be closed synchronously — always prefer guard.close().await before the guard goes out of scope.

Example

let guard = TabGuard::new(engine.new_tab().await?);
let page = guard.tab().goto(url).await?;
// ... use tab ...
guard.close().await; // explicit async close

Implementations

impl TabGuard

pub fn new(tab: Box<dyn BrowserTab>) -> Self

Create a new guard wrapping an opened tab.

pub fn tab(&self) -> &dyn BrowserTab

Access the underlying tab reference.

Panics

Panics if the guard has already been consumed (via close or into_inner).

pub async fn close(self)

Explicitly close the tab and consume the guard.

If close() fails on the underlying tab, a warning is logged but no error is propagated — the guard is still consumed.

pub fn into_inner(self) -> Box<dyn BrowserTab>

Take ownership of the tab without closing it.

Useful when transferring tab ownership to a longer-lived scope (e.g., multi-step script execution).

Trait Implementations

impl Drop for TabGuard

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.