feat(browser): add support for the new headless mode in BrowserConfig (…

…#208)

* feat(browser): add support for the new headless mode in BrowserConfig

* miscellaneous enhancements following dda6ff

* further fixes

src/browser.rs

@@ -559,11 +559,22 @@ async fn ws_url_from_output(
     }
 }
 
+#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
+pub enum HeadlessMode {
+    /// The "headful" mode.
+    False,
+    /// The old headless mode.
+    #[default]
+    True,
+    /// The new headless mode. See also: https://developer.chrome.com/docs/chromium/new-headless
+    New,
+}
+
 #[derive(Debug, Clone)]
 pub struct BrowserConfig {
     /// Determines whether to run headless version of the browser. Defaults to
     /// true.
-    headless: bool,
+    headless: HeadlessMode,
     /// Determines whether to run the browser with a sandbox.
     sandbox: bool,
     /// Launch the browser with a specific window width and height.
@@ -619,7 +630,7 @@ pub struct BrowserConfig {
 
 #[derive(Debug, Clone)]
 pub struct BrowserConfigBuilder {
-    headless: bool,
+    headless: HeadlessMode,
     sandbox: bool,
     window_size: Option<(u32, u32)>,
     port: u16,
@@ -652,7 +663,7 @@ impl BrowserConfig {
 impl Default for BrowserConfigBuilder {
     fn default() -> Self {
         Self {
-            headless: true,
+            headless: HeadlessMode::True,
             sandbox: true,
             window_size: None,
             port: 0,
@@ -686,7 +697,17 @@ impl BrowserConfigBuilder {
     }
 
     pub fn with_head(mut self) -> Self {
-        self.headless = false;
+        self.headless = HeadlessMode::False;
+        self
+    }
+
+    pub fn new_headless_mode(mut self) -> Self {
+        self.headless = HeadlessMode::New;
+        self
+    }
+
+    pub fn headless_mode(mut self, mode: HeadlessMode) -> Self {
+        self.headless = mode;
         self
     }
 
@@ -889,8 +910,16 @@ impl BrowserConfig {
             cmd.args(["--no-sandbox", "--disable-setuid-sandbox"]);
         }
 
-        if self.headless {
-            cmd.args(["--headless", "--hide-scrollbars", "--mute-audio"]);
+        match self.headless {
+            HeadlessMode::False => (),
+            HeadlessMode::True => {
+                cmd.args(["--headless", "--hide-scrollbars", "--mute-audio"]);
+                ()
+            }
+            HeadlessMode::New => {
+                cmd.args(["--headless=new", "--hide-scrollbars", "--mute-audio"]);
+                ()
+            }
         }
 
         if self.incognito {