Struct BrowserSession 

pub struct BrowserSession { /* private fields */ }

One Chrome process with any number of pages.

Implementations

impl BrowserSession

pub async fn launch(opts: LaunchOptions) -> Result<Self>

pub fn id(&self) -> &str

pub fn process_id(&self) -> Option<u32>

OS process id of the Chrome child this session owns.

pub fn pinned_connections(&self) -> Vec<PinnedConnection>

Connections the pinning proxy made, with the address it pinned for each.

pub fn is_headless(&self) -> bool

pub fn profile_dir(&self) -> &Path

pub fn download_dir(&self) -> &Path

pub async fn new_page(&self, url: &str) -> Result<Arc<BrowserPage>>

Open a new page (tab), make it current, and navigate to url.

pub fn pages(&self) -> Vec<Arc<BrowserPage>>

pub fn page(&self, id: &str) -> Result<Arc<BrowserPage>>

pub fn current(&self) -> Result<Arc<BrowserPage>>

The page actions default to.

pub async fn select_page(&self, id: &str) -> Result<Arc<BrowserPage>>

Make id current and bring it to the front.

pub async fn close_page(&self, id: &str) -> Result<()>

pub fn downloads(&self) -> HashSet<PathBuf>

Completed files currently in the download directory.

pub async fn wait_download( &self, before: &HashSet<PathBuf>, timeout: Duration, ) -> Result<PathBuf>

Wait for a download not in before to finish (no .crdownload, stable size).

pub async fn set_permission( &self, origin: Option<&str>, name: &str, granted: bool, ) -> Result<()>

Set a W3C permission (geolocation, notifications, clipboard-read, midi, …) to granted or denied for origin, or every origin when None.

pub async fn reset_permissions(&self) -> Result<()>

pub async fn shutdown(&self)

Close Chrome gracefully: CDP Browser.close and up to 5 s for exit, then SIGTERM to the process group and up to 5 s more, then SIGKILL (job termination on Windows). Safe to call twice. A temporary profile is deleted once Chrome has exited.

pub async fn cancel(&self)

Cancel: kill the owned Chrome now and wait for it to exit. Helper processes exit with their parent; none are detached.

Trait Implementations

impl Drop for BrowserSession

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.