Struct TabRegistry 

pub struct TabRegistry<P> { /* private fields */ }

Ordered collection of open tabs plus which one is active. Generic over the page handle type P so the state machine is unit testable without a live CDP connection — the tests module below drives it with a plain &str standing in for chromiumoxide::Page.

Implementations

impl<P: Clone> TabRegistry<P>

pub fn new() -> (Self, Receiver<TabsSnapshot>)

A registry with no tabs open and no active tab — the well-defined empty state.

pub fn subscribe(&self) -> Receiver<TabsSnapshot>

A new receiver tuned to the current state — borrow() sees the latest snapshot immediately; changed() waits for the next one.

pub fn open( &mut self, page: P, url: impl Into<String>, title: impl Into<String>, ) -> TabId

Open a new tab wrapping page, and make it active. Returns the new tab’s id.

pub fn close(&mut self, id: TabId) -> Option<P>

Close id. Returns its page handle (so the caller can drive the CDP-level close) if it existed — None if there was no such tab, a safe no-op rather than an error.

Closing the active tab activates a neighbor: prefer the tab that slides into the closed one’s position (the tab that was to its right), falling back to the tab now at the end (previously to its left) if it was the rightmost tab, falling back to None if it was the last tab open — the well-defined empty state.

pub fn close_all(&mut self) -> Vec<P>

Close every open tab. Returns their page handles in closing order, so the caller can drive a CDP-level close for each. Equivalent to calling Self::close on every currently-open id.

pub fn switch(&mut self, id: TabId) -> Result<(), TabError>

Make id the active tab. Errors if no tab has that id. A no-op (still Ok, no event published) if id is already active.

pub fn active_id(&self) -> Option<TabId>

The active tab’s id, if any (None in the empty state).

pub fn active_url(&self) -> Option<String>

The active tab’s cached URL, if any. Used to keep a scalar “last known URL” cache in sync with whichever tab is active, without a live CDP round trip.

pub fn active_page(&self) -> Option<P>

The active tab’s page handle, if any.

pub fn page(&self, id: TabId) -> Option<P>

id’s page handle, if it’s an open tab.

pub fn pages(&self) -> Vec<(TabId, P)>

Every open tab’s id + page handle, in tab-strip order. Used to drive a live nav-state refresh across ALL tabs, not just the active one — a background tab can navigate on its own (a clicked link, a JS redirect) without ever going through ChromiumBackend::navigate.

pub fn list(&self) -> Vec<TabInfo>

Current tab list in strip order, each flagged with whether it’s the active one.

pub fn update_nav_state( &mut self, id: TabId, url: impl Into<String>, title: impl Into<String>, can_go_back: bool, can_go_forward: bool, )

Update id’s cached nav state. A no-op (including no published event) if none of the fields actually changed, or if id doesn’t exist — keeps the watch channel free of churn from a caller that refreshes on every poll regardless of whether anything actually moved (see ChromiumBackend::list_tabs).