seleniumbase 4.31.0__py3-none-any.whl → 4.31.1__py3-none-any.whl

seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.31.0"
+__version__ = "4.31.1"

seleniumbase/behave/behave_sb.py

@@ -44,8 +44,9 @@ behave -D agent="User Agent String" -D demo
 -D sjw  (Skip JS Waits for readyState to be "complete" or Angular to load.)
 -D wfa  (Wait for AngularJS to be done loading after specific web actions.)
 -D pls=PLS  (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
--D headless  (Run tests in headless mode. The default arg on Linux OS.)
--D headless2  (Use the new headless mode, which supports extensions.)
+-D headless  (The default headless mode. Linux uses this mode by default.)
+-D headless1  (Use Chrome's old headless mode. Fast, but has limitations.)
+-D headless2  (Use Chrome's new headless mode, which supports extensions.)
 -D headed  (Run tests in headed/GUI mode on Linux OS, where not default.)
 -D xvfb  (Run tests using the Xvfb virtual display server on Linux OS.)
 -D xvfb-metrics=STRING  (Set Xvfb display size on Linux: "Width,Height".)
@@ -144,6 +145,7 @@ def get_configured_sb(context):
     sb.browser = "chrome"
     sb.is_behave = True
     sb.headless = False
+    sb.headless1 = False
     sb.headless2 = False
     sb.headless_active = False
     sb.headed = False
@@ -296,6 +298,11 @@ def get_configured_sb(context):
             sb.headless = True
             continue
         # Handle: -D headless2
+        if low_key == "headless1":
+            sb.headless1 = True
+            sb.headless = True
+            continue
+        # Handle: -D headless2
         if low_key == "headless2":
             sb.headless2 = True
             continue
@@ -864,6 +871,7 @@ def get_configured_sb(context):
     # Recorder Mode can still optimize scripts in "-D headless2" mode.
     if sb.recorder_ext and sb.headless:
         sb.headless = False
+        sb.headless1 = False
         sb.headless2 = True
     if sb.headless2 and sb.browser == "firefox":
         sb.headless2 = False  # Only for Chromium browsers
@@ -900,11 +908,13 @@ def get_configured_sb(context):
     # Recorder Mode can still optimize scripts in --headless2 mode.
     if sb.recorder_mode and sb.headless:
         sb.headless = False
+        sb.headless1 = False
         sb.headless2 = True
     if not sb.headless and not sb.headless2:
         sb.headed = True
     if sb.browser == "safari" and sb.headless:
         sb.headless = False  # Safari doesn't support headless mode
+        sb.headless1 = False
     if sb.save_screenshot_after_test and sb.no_screenshot_after_test:
         sb.save_screenshot_after_test = False  # "no_screenshot" has priority
     if sb.servername != "localhost":

seleniumbase/console_scripts/logo_helper.py

@@ -3,7 +3,9 @@
     http://www.patorjk.com/software/taag/#p=display&f=Slant&t=SeleniumBase """
 
 import colorama
+import os
 import sys
+from contextlib import suppress
 
 r"""
    ______     __           _                  ____
@@ -66,4 +68,49 @@ def get_seleniumbase_logo():
     sb += "                        "
     sb += cr
     sb += cr
+    with suppress(Exception):
+        terminal_width = os.get_terminal_size().columns
+        if isinstance(terminal_width, int) and terminal_width >= 66:
+            return sb
+
+    # If the logo is wider than the screen width, use a smaller one:
+    r"""
+     ___      _          _             ___
+    / __| ___| |___ _ _ (_)_  _ _ __  | _ ) __ _ ______
+    \__ \/ -_) / -_) ' \| | \| | '  \ | _ \/ _` (_-< -_)
+    |___/\___|_\___|_||_|_|\_,_|_|_|_\|___/\__,_/__|___|
+    """
+    sb = " "
+    sb += cr
+    sb += "\n"
+    sb += c1
+    sb += " ___      _          _            "
+    sb += c2
+    sb += " ___              "
+    sb += cr
+    sb += "\n"
+    sb += c1
+    sb += "/ __| ___| |___ _ _ (_)_  _ _ __  "
+    sb += c2
+    sb += "| _ ) __ _ ______ "
+    sb += cr
+    sb += "\n"
+    sb += c1
+    sb += "\\__ \\/ -_) / -_) ' \\| | \\| | '  \\ "
+    sb += c2
+    sb += "| _ \\/ _` (_-< -_)"
+    sb += cr
+    sb += "\n"
+    sb += c1
+    sb += "|___/\\___|_\\___|_||_|_|\\_,_|_|_|_\\"
+    sb += c2
+    sb += "|___/\\__,_/__|___|"
+    sb += cr
+    sb += "\n"
+    sb += c3
+    sb += "                                  "
+    sb += c4
+    sb += "                  "
+    sb += cr
+    sb += cr
     return sb

seleniumbase/console_scripts/run.py

@@ -54,8 +54,8 @@ else:
 def show_usage():
     show_basic_usage()
     sc = ""
-    sc += '    Type "sbase help [COMMAND]" for specific command info.\n'
-    sc += '    For info on all commands, type: "seleniumbase --help".\n'
+    sc += '    Type "sbase help [COMMAND]" for specific info.\n'
+    sc += '    For all commands, type: "seleniumbase --help".\n'
     sc += '    Use "pytest" for running tests.\n'
     if "linux" not in sys.platform:
         c1 = colorama.Fore.BLUE + colorama.Back.LIGHTCYAN_EX
@@ -76,12 +76,15 @@ def show_basic_usage():
 
     seleniumbase_logo = logo_helper.get_seleniumbase_logo()
     print(seleniumbase_logo)
+    time.sleep(0.044)
     print("")
-    time.sleep(0.28)  # Enough time to see the logo
+    time.sleep(0.033)
     show_package_location()
+    time.sleep(0.032)
     show_version_info()
+    time.sleep(0.031)
     print("")
-    time.sleep(0.62)  # Enough time to see the version
+    time.sleep(0.68)  # Enough time to see the logo & version
     sc = ""
     sc += ' * USAGE: "seleniumbase [COMMAND] [PARAMETERS]"\n'
     sc += ' *    OR:        "sbase [COMMAND] [PARAMETERS]"\n'

seleniumbase/core/browser_launcher.py

@@ -203,6 +203,8 @@ def extend_driver(driver):
     driver.is_exact_text_visible = DM.is_exact_text_visible
     driver.is_attribute_present = DM.is_attribute_present
     driver.is_non_empty_text_visible = DM.is_non_empty_text_visible
+    driver.is_valid_url = DM.is_valid_url
+    driver.is_alert_present = DM.is_alert_present
     driver.is_online = DM.is_online
     driver.js_click = DM.js_click
     driver.get_text = DM.get_text
@@ -1553,6 +1555,7 @@ def _set_chrome_options(
     log_cdp_events,
     no_sandbox,
     disable_gpu,
+    headless1,
     headless2,
     incognito,
     guest_mode,
@@ -1771,7 +1774,10 @@ def _set_chrome_options(
             pass  # Processed After Version Check
     elif headless:
         if not undetectable:
-            chrome_options.add_argument("--headless")
+            if headless1:
+                chrome_options.add_argument("--headless=old")
+            else:
+                chrome_options.add_argument("--headless")
         if undetectable and servername and servername != "localhost":
             # The Grid Node will need Chrome 109 or newer
             chrome_options.add_argument("--headless=new")
@@ -2193,6 +2199,7 @@ def get_driver(
     log_cdp_events=False,
     no_sandbox=False,
     disable_gpu=False,
+    headless1=False,
     headless2=False,
     incognito=False,
     guest_mode=False,
@@ -2406,6 +2413,7 @@ def get_driver(
             log_cdp_events,
             no_sandbox,
             disable_gpu,
+            headless1,
             headless2,
             incognito,
             guest_mode,
@@ -2462,6 +2470,7 @@ def get_driver(
             log_cdp_events,
             no_sandbox,
             disable_gpu,
+            headless1,
             headless2,
             incognito,
             guest_mode,
@@ -2522,6 +2531,7 @@ def get_remote_driver(
     log_cdp_events,
     no_sandbox,
     disable_gpu,
+    headless1,
     headless2,
     incognito,
     guest_mode,
@@ -2657,6 +2667,7 @@ def get_remote_driver(
             log_cdp_events,
             no_sandbox,
             disable_gpu,
+            headless1,
             headless2,
             incognito,
             guest_mode,
@@ -2829,6 +2840,7 @@ def get_remote_driver(
             log_cdp_events,
             no_sandbox,
             disable_gpu,
+            headless1,
             headless2,
             incognito,
             guest_mode,
@@ -2948,6 +2960,7 @@ def get_local_driver(
     log_cdp_events,
     no_sandbox,
     disable_gpu,
+    headless1,
     headless2,
     incognito,
     guest_mode,
@@ -3425,8 +3438,14 @@ def get_local_driver(
                 else:
                     pass  # Will need Xvfb on Linux
         elif headless:
-            if "--headless" not in edge_options.arguments:
-                edge_options.add_argument("--headless")
+            if (
+                "--headless" not in edge_options.arguments
+                and "--headless=old" not in edge_options.arguments
+            ):
+                if headless1:
+                    edge_options.add_argument("--headless=old")
+                else:
+                    edge_options.add_argument("--headless")
         if mobile_emulator and not is_using_uc(undetectable, browser_name):
             emulator_settings = {}
             device_metrics = {}
@@ -3788,6 +3807,7 @@ def get_local_driver(
                 log_cdp_events,
                 no_sandbox,
                 disable_gpu,
+                headless1,
                 headless2,
                 incognito,
                 guest_mode,
@@ -3960,8 +3980,14 @@ def get_local_driver(
                 except Exception:
                     pass  # Will need Xvfb on Linux
             elif headless:
-                if "--headless" not in chrome_options.arguments:
-                    chrome_options.add_argument("--headless")
+                if (
+                    "--headless" not in chrome_options.arguments
+                    and "--headless=old" not in chrome_options.arguments
+                ):
+                    if headless1:
+                        chrome_options.add_argument("--headless=old")
+                    else:
+                        chrome_options.add_argument("--headless")
             if LOCAL_CHROMEDRIVER and os.path.exists(LOCAL_CHROMEDRIVER):
                 try:
                     make_driver_executable_if_not(LOCAL_CHROMEDRIVER)
@@ -4227,6 +4253,12 @@ def get_local_driver(
                                     chrome_options.arguments.remove(
                                         "--headless"
                                     )
+                                if "--headless=old" in (
+                                    chrome_options.arguments
+                                ):
+                                    chrome_options.arguments.remove(
+                                        "--headless=old"
+                                    )
                             uc_chrome_version = None
                             if (
                                 use_version.isnumeric()
@@ -4300,6 +4332,7 @@ def get_local_driver(
                                         False,  # log_cdp_events
                                         no_sandbox,
                                         disable_gpu,
+                                        False,  # headless1
                                         False,  # headless2
                                         incognito,
                                         guest_mode,
@@ -4541,6 +4574,7 @@ def get_local_driver(
                         False,  # log_cdp_events
                         no_sandbox,
                         disable_gpu,
+                        False,  # headless1
                         False,  # headless2
                         incognito,
                         guest_mode,
@@ -4792,6 +4826,8 @@ def get_local_driver(
                     )
                     if "--headless" in chrome_options.arguments:
                         chrome_options.arguments.remove("--headless")
+                    if "--headless=old" in chrome_options.arguments:
+                        chrome_options.arguments.remove("--headless=old")
                     service = ChromeService(
                         log_output=os.devnull,
                         service_args=["--disable-build-check"]

seleniumbase/core/sb_driver.py

@@ -161,6 +161,17 @@ class DriverMethods():
             self.driver, *args, **kwargs
         )
 
+    def is_valid_url(self, url):
+        """Return True if the url is a valid url."""
+        return page_utils.is_valid_url(url)
+
+    def is_alert_present(self):
+        try:
+            self.driver.switch_to.alert
+            return True
+        except Exception:
+            return False
+
     def is_online(self):
         return self.driver.execute_script("return navigator.onLine;")
 

seleniumbase/fixtures/base_case.py

@@ -3771,6 +3771,7 @@ class BaseCase(unittest.TestCase):
         log_cdp_events=None,
         no_sandbox=None,
         disable_gpu=None,
+        headless1=None,
         headless2=None,
         incognito=None,
         guest_mode=None,
@@ -3830,6 +3831,7 @@ class BaseCase(unittest.TestCase):
         log_cdp_events - capture {"performance": "ALL", "browser": "ALL"})
         no_sandbox - the option to enable the "No-Sandbox" feature (Chrome)
         disable_gpu - the option to enable Chrome's "Disable GPU" feature
+        headless1 - the option to use the older headless mode (Chromium)
         headless2 - the option to use the newer headless mode (Chromium)
         incognito - the option to enable Chrome's Incognito mode (Chrome)
         guest_mode - the option to enable Chrome's Guest mode (Chrome)
@@ -3938,6 +3940,8 @@ class BaseCase(unittest.TestCase):
             no_sandbox = self.no_sandbox
         if disable_gpu is None:
             disable_gpu = self.disable_gpu
+        if headless1 is None:
+            headless1 = self.headless1
         if headless2 is None:
             headless2 = self.headless2
         if incognito is None:
@@ -4036,6 +4040,7 @@ class BaseCase(unittest.TestCase):
             log_cdp_events=log_cdp_events,
             no_sandbox=no_sandbox,
             disable_gpu=disable_gpu,
+            headless1=headless1,
             headless2=headless2,
             incognito=incognito,
             guest_mode=guest_mode,
@@ -7808,6 +7813,13 @@ class BaseCase(unittest.TestCase):
         """Return True if the url is a valid url."""
         return page_utils.is_valid_url(url)
 
+    def is_alert_present(self):
+        try:
+            self.driver.switch_to.alert
+            return True
+        except Exception:
+            return False
+
     def is_online(self):
         """Return True if connected to the Internet."""
         return self.execute_script("return navigator.onLine;")
@@ -14324,6 +14336,10 @@ class BaseCase(unittest.TestCase):
             self.env = self.environment  # Add a shortened version
             self.with_selenium = sb_config.with_selenium  # Should be True
             self.headless = sb_config.headless
+            self.headless1 = sb_config.headless1
+            if self.headless1:
+                self.headless = True
+            self.headless2 = sb_config.headless2
             self.headless_active = False
             sb_config.headless_active = False
             self.headed = sb_config.headed
@@ -14392,7 +14408,6 @@ class BaseCase(unittest.TestCase):
             self.log_cdp_events = sb_config.log_cdp_events
             self.no_sandbox = sb_config.no_sandbox
             self.disable_gpu = sb_config.disable_gpu
-            self.headless2 = sb_config.headless2
             self.incognito = sb_config.incognito
             self.guest_mode = sb_config.guest_mode
             self.dark_mode = sb_config.dark_mode
@@ -14768,6 +14783,7 @@ class BaseCase(unittest.TestCase):
                 log_cdp_events=self.log_cdp_events,
                 no_sandbox=self.no_sandbox,
                 disable_gpu=self.disable_gpu,
+                headless1=self.headless1,
                 headless2=self.headless2,
                 incognito=self.incognito,
                 guest_mode=self.guest_mode,

seleniumbase/fixtures/page_utils.py

@@ -163,12 +163,15 @@ def is_valid_url(url):
         r"(?:/?|[/?]\S+)$",
         re.IGNORECASE,
     )
-    return (
+    if (
         regex.match(url)
         or url.startswith((
             "about:", "blob:", "chrome:", "data:", "edge:", "file:"
         ))
-    )
+    ):
+        return True
+    else:
+        return False
 
 
 def _get_unique_links(page_url, soup):

seleniumbase/plugins/driver_manager.py

@@ -65,8 +65,9 @@ class DriverContext():
 
 def Driver(
     browser=None,  # Choose from "chrome", "edge", "firefox", or "safari".
-    headless=None,  # The original headless mode for Chromium and Firefox.
-    headless2=None,  # Chromium's new headless mode. (Has more features)
+    headless=None,  # Use the default headless mode for Chromium and Firefox.
+    headless1=None,  # Use Chromium's old headless mode. (Fast, but limited)
+    headless2=None,  # Use Chromium's new headless mode. (Has more features)
     headed=None,  # Run tests in headed/GUI mode on Linux, where not default.
     locale_code=None,  # Set the Language Locale Code for the web browser.
     protocol=None,  # The Selenium Grid protocol: "http" or "https".
@@ -154,74 +155,75 @@ def Driver(
 
     Optional Parameters:
     --------------------
-    browser:  # Choose from "chrome", "edge", "firefox", or "safari".
-    headless:  # The original headless mode for Chromium and Firefox.
-    headless2:  # Chromium's new headless mode. (Has more features)
-    headed:  # Run tests in headed/GUI mode on Linux, where not default.
-    locale_code:  # Set the Language Locale Code for the web browser.
-    protocol:  # The Selenium Grid protocol: "http" or "https".
-    servername:  # The Selenium Grid server/IP used for tests.
-    port:  # The Selenium Grid port used by the test server.
-    proxy:  # Use proxy. Format: "SERVER:PORT" or "USER:PASS@SERVER:PORT".
-    proxy_bypass_list:  # Skip proxy when using the listed domains.
-    proxy_pac_url:  # Use PAC file. (Format: URL or USERNAME:PASSWORD@URL)
-    multi_proxy:  # Allow multiple proxies with auth when multi-threaded.
-    agent:  # Modify the web browser's User-Agent string.
-    cap_file:  # The desired capabilities to use with a Selenium Grid.
-    cap_string:  # The desired capabilities to use with a Selenium Grid.
-    recorder_ext:  # Enables the SeleniumBase Recorder Chromium extension.
-    disable_js:  # Disable JavaScript on websites. Pages might break!
-    disable_csp:  # Disable the Content Security Policy of websites.
-    enable_ws:  # Enable Web Security on Chromium-based browsers.
-    disable_ws:  # Reverse of "enable_ws". (None and False are different)
-    enable_sync:  # Enable "Chrome Sync" on websites.
-    use_auto_ext:  # Use Chrome's automation extension.
-    undetectable:  # Use undetected-chromedriver to evade bot-detection.
-    uc_cdp_events:  # Capture CDP events in undetected-chromedriver mode.
-    uc_subprocess:  # Use undetected-chromedriver as a subprocess.
-    log_cdp_events:  # Capture {"performance": "ALL", "browser": "ALL"}
-    no_sandbox:  # (DEPRECATED) - "--no-sandbox" is always used now.
-    disable_gpu:  # (DEPRECATED) - GPU is disabled if not "swiftshader".
-    incognito:  # Enable Chromium's Incognito mode.
-    guest_mode:  # Enable Chromium's Guest mode.
-    dark_mode:  # Enable Chromium's Dark mode.
-    devtools:  # Open Chromium's DevTools when the browser opens.
-    remote_debug:  # Enable Chrome's Debugger on "http://localhost:9222".
-    enable_3d_apis:  # Enable WebGL and 3D APIs.
-    swiftshader:  # Chrome: --use-gl=angle / --use-angle=swiftshader-webgl
-    ad_block_on:  # Block some types of display ads from loading.
-    host_resolver_rules:  # Set host-resolver-rules, comma-separated.
-    block_images:  # Block images from loading during tests.
-    do_not_track:  # Tell websites that you don't want to be tracked.
-    chromium_arg:  # "ARG=N,ARG2" (Set Chromium args, ","-separated.)
-    firefox_arg:  # "ARG=N,ARG2" (Set Firefox args, comma-separated.)
-    firefox_pref:  # SET (Set Firefox PREFERENCE:VALUE set, ","-separated)
-    user_data_dir:  # Set the Chrome user data directory to use.
-    extension_zip:  # Load a Chrome Extension .zip|.crx, comma-separated.
-    extension_dir:  # Load a Chrome Extension directory, comma-separated.
-    disable_features:  # "F1,F2" (Disable Chrome features, ","-separated.)
-    binary_location:  # Set path of the Chromium browser binary to use.
-    driver_version:  # Set the chromedriver or uc_driver version to use.
-    page_load_strategy:  # Set Chrome PLS to "normal", "eager", or "none".
-    use_wire:  # Use selenium-wire's webdriver over selenium webdriver.
-    external_pdf:  # Set Chrome "plugins.always_open_pdf_externally":True.
-    window_position:  # Set the browser's starting window position: "X,Y"
-    window_size:  # Set the browser's starting window size: "Width,Height"
-    is_mobile:  # Use the mobile device emulator while running tests.
-    mobile:  # Shortcut / Duplicate of "is_mobile".
-    d_width:  # Set device width
-    d_height:  # Set device height
-    d_p_r:  # Set device pixel ratio
-    uc:  # Shortcut / Duplicate of "undetectable".
-    undetected:  # Shortcut / Duplicate of "undetectable".
-    uc_cdp:  # Shortcut / Duplicate of "uc_cdp_events".
-    uc_sub:  # Shortcut / Duplicate of "uc_subprocess".
-    log_cdp:  # Shortcut / Duplicate of "log_cdp_events".
-    ad_block:  # Shortcut / Duplicate of "ad_block_on".
-    server:  # Shortcut / Duplicate of "servername".
-    guest:  # Shortcut / Duplicate of "guest_mode".
-    wire:  # Shortcut / Duplicate of "use_wire".
-    pls:  # Shortcut / Duplicate of "page_load_strategy".
+    browser (str):  Choose from "chrome", "edge", "firefox", or "safari".
+    headless (bool):  Use the default headless mode for Chromium and Firefox.
+    headless1 (bool):  Use Chromium's old headless mode. (Fast, but limited)
+    headless2 (bool):  Use Chromium's new headless mode. (Has more features)
+    headed (bool):  Run tests in headed/GUI mode on Linux, where not default.
+    locale_code (str):  Set the Language Locale Code for the web browser.
+    protocol (str):  The Selenium Grid protocol: "http" or "https".
+    servername (str):  The Selenium Grid server/IP used for tests.
+    port (int):  The Selenium Grid port used by the test server.
+    proxy (str):  Use proxy. Format: "SERVER:PORT" or "USER:PASS@SERVER:PORT".
+    proxy_bypass_list (str):  Skip proxy when using the listed domains.
+    proxy_pac_url (str):  Use PAC file. (Format: URL or USERNAME:PASSWORD@URL)
+    multi_proxy (bool):  Allow multiple proxies with auth when multi-threaded.
+    agent (str):  Modify the web browser's User-Agent string.
+    cap_file (str):  The desired capabilities to use with a Selenium Grid.
+    cap_string (str):  The desired capabilities to use with a Selenium Grid.
+    recorder_ext (bool):  Enables the SeleniumBase Recorder Chromium extension.
+    disable_js (bool):  Disable JavaScript on websites. Pages might break!
+    disable_csp (bool):  Disable the Content Security Policy of websites.
+    enable_ws (bool):  Enable Web Security on Chromium-based browsers.
+    disable_ws (bool):  Reverse of "enable_ws". (None and False are different)
+    enable_sync (bool):  Enable "Chrome Sync" on websites.
+    use_auto_ext (bool):  Use Chrome's automation extension.
+    undetectable (bool):  Use undetected-chromedriver to evade bot-detection.
+    uc_cdp_events (bool):  Capture CDP events in undetected-chromedriver mode.
+    uc_subprocess (bool):  Use undetected-chromedriver as a subprocess.
+    log_cdp_events (bool):  Capture {"performance": "ALL", "browser": "ALL"}
+    no_sandbox (bool):  (DEPRECATED) - "--no-sandbox" is always used now.
+    disable_gpu (bool):  (DEPRECATED) - GPU is disabled if not "swiftshader".
+    incognito (bool):  Enable Chromium's Incognito mode.
+    guest_mode (bool):  Enable Chromium's Guest mode.
+    dark_mode (bool):  Enable Chromium's Dark mode.
+    devtools (bool):  Open Chromium's DevTools when the browser opens.
+    remote_debug (bool):  Enable Chrome's Debugger on "http://localhost:9222".
+    enable_3d_apis (bool):  Enable WebGL and 3D APIs.
+    swiftshader (bool):  Chrome: --use-gl=angle / --use-angle=swiftshader-webgl
+    ad_block_on (bool):  Block some types of display ads from loading.
+    host_resolver_rules (str):  Set host-resolver-rules, comma-separated.
+    block_images (bool):  Block images from loading during tests.
+    do_not_track (bool):  Tell websites that you don't want to be tracked.
+    chromium_arg (str):  "ARG=N,ARG2" (Set Chromium args, ","-separated.)
+    firefox_arg (str):  "ARG=N,ARG2" (Set Firefox args, comma-separated.)
+    firefox_pref (str):  SET (Set Firefox PREFERENCE:VALUE set, ","-separated)
+    user_data_dir (str):  Set the Chrome user data directory to use.
+    extension_zip (str):  Load a Chrome Extension .zip|.crx, comma-separated.
+    extension_dir (str):  Load a Chrome Extension directory, comma-separated.
+    disable_features (str):  "F1,F2" (Disable Chrome features, ","-separated.)
+    binary_location (str):  Set path of the Chromium browser binary to use.
+    driver_version (str):  Set the chromedriver or uc_driver version to use.
+    page_load_strategy (str):  Set Chrome PLS to "normal", "eager", or "none".
+    use_wire (bool):  Use selenium-wire's webdriver over selenium webdriver.
+    external_pdf (bool):  Set Chrome "plugins.always_open_pdf_externally":True
+    window_position (x,y):  Set the browser's starting window position: "X,Y"
+    window_size (w,h):  Set the browser's starting window size: "Width,Height"
+    is_mobile (bool):  Use the mobile device emulator while running tests.
+    mobile (bool):  Shortcut / Duplicate of "is_mobile".
+    d_width (int):  Set device width
+    d_height (int):  Set device height
+    d_p_r (float):  Set device pixel ratio
+    uc (bool):  Shortcut / Duplicate of "undetectable".
+    undetected (bool):  Shortcut / Duplicate of "undetectable".
+    uc_cdp (bool):  Shortcut / Duplicate of "uc_cdp_events".
+    uc_sub (bool):  Shortcut / Duplicate of "uc_subprocess".
+    log_cdp (bool):  Shortcut / Duplicate of "log_cdp_events".
+    ad_block (bool):  Shortcut / Duplicate of "ad_block_on".
+    server (str):  Shortcut / Duplicate of "servername".
+    guest (bool):  Shortcut / Duplicate of "guest_mode".
+    wire (bool):  Shortcut / Duplicate of "use_wire".
+    pls (str):  Shortcut / Duplicate of "page_load_strategy".
     """
     from seleniumbase import config as sb_config
     from seleniumbase.config import settings
@@ -336,6 +338,13 @@ def Driver(
             headless = True
         else:
             headless = False
+    if headless1 is None:
+        if "--headless1" in sys_argv:
+            headless1 = True
+        else:
+            headless1 = False
+    if headless1:
+        headless = True
     if headless2 is None:
         if "--headless2" in sys_argv:
             headless2 = True
@@ -601,6 +610,7 @@ def Driver(
         headless = True
     if recorder_mode and headless:
         headless = False
+        headless1 = False
         headless2 = True
     if headless2 and browser == "firefox":
         headless2 = False  # Only for Chromium browsers
@@ -773,6 +783,7 @@ def Driver(
         log_cdp_events=log_cdp_events,
         no_sandbox=no_sandbox,
         disable_gpu=disable_gpu,
+        headless1=headless1,
         headless2=headless2,
         incognito=incognito,
         guest_mode=guest_mode,

seleniumbase/plugins/pytest_plugin.py

@@ -62,8 +62,9 @@ def pytest_addoption(parser):
     --sjw  (Skip JS Waits for readyState to be "complete" or Angular to load.)
     --wfa  (Wait for AngularJS to be done loading after specific web actions.)
     --pls=PLS  (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
-    --headless  (Run tests in headless mode. The default arg on Linux OS.)
-    --headless2  (Use the new headless mode, which supports extensions.)
+    --headless  (The default headless mode. Linux uses this mode by default.)
+    --headless1  (Use Chrome's old headless mode. Fast, but has limitations.)
+    --headless2  (Use Chrome's new headless mode, which supports extensions.)
     --headed  (Run tests in headed/GUI mode on Linux OS, where not default.)
     --xvfb  (Run tests using the Xvfb virtual display server on Linux OS.)
     --xvfb-metrics=STRING  (Set Xvfb display size on Linux: "Width,Height".)
@@ -700,6 +701,15 @@ def pytest_addoption(parser):
                 UNLESS using a virtual display with Xvfb.
                 Default: False on Mac/Windows. True on Linux.""",
     )
+    parser.addoption(
+        "--headless1",
+        action="store_true",
+        dest="headless1",
+        default=False,
+        help="""This option activates the old headless mode,
+                which is faster, but has limitations.
+                (May be phased out by Chrome in the future.)""",
+    )
     parser.addoption(
         "--headless2",
         action="store_true",
@@ -1533,6 +1543,9 @@ def pytest_configure(config):
     sb_config.mobile_emulator = config.getoption("mobile_emulator")
     sb_config.device_metrics = config.getoption("device_metrics")
     sb_config.headless = config.getoption("headless")
+    sb_config.headless1 = config.getoption("headless1")
+    if sb_config.headless1:
+        sb_config.headless = True
     sb_config.headless2 = config.getoption("headless2")
     if sb_config.headless2 and sb_config.browser == "firefox":
         sb_config.headless2 = False  # Only for Chromium browsers
@@ -1759,6 +1772,7 @@ def pytest_configure(config):
     # Recorder Mode can still optimize scripts in --headless2 mode.
     if sb_config.recorder_mode and sb_config.headless:
         sb_config.headless = False
+        sb_config.headless1 = False
         sb_config.headless2 = True
 
     if not sb_config.headless and not sb_config.headless2:
@@ -1779,6 +1793,7 @@ def pytest_configure(config):
 
     if sb_config.browser == "safari" and sb_config.headless:
         sb_config.headless = False  # Safari doesn't support headless mode
+        sb_config.headless1 = False
 
     if sb_config.dash_title:
         constants.Dashboard.TITLE = sb_config.dash_title.replace("_", " ")

seleniumbase/plugins/sb_manager.py

@@ -32,8 +32,9 @@ def SB(
     rtf=None,  # Shortcut / Duplicate of "raise_test_failure".
     raise_test_failure=None,  # If "test" mode, raise Exception on 1st failure.
     browser=None,  # Choose from "chrome", "edge", "firefox", or "safari".
-    headless=None,  # The original headless mode for Chromium and Firefox.
-    headless2=None,  # Chromium's new headless mode. (Has more features)
+    headless=None,  # Use the default headless mode for Chromium and Firefox.
+    headless1=None,  # Use Chromium's old headless mode. (Fast, but limited)
+    headless2=None,  # Use Chromium's new headless mode. (Has more features)
     locale_code=None,  # Set the Language Locale Code for the web browser.
     protocol=None,  # The Selenium Grid protocol: "http" or "https".
     servername=None,  # The Selenium Grid server/IP used for tests.
@@ -146,104 +147,105 @@ def SB(
 
     Optional Parameters:
     --------------------
-    test:  Test Mode: Output, Logging, Continue on failure unless "rtf".
-    rtf:  Shortcut / Duplicate of "raise_test_failure".
-    raise_test_failure:  If "test" mode, raise Exception on 1st failure.
-    browser:  Choose from "chrome", "edge", "firefox", or "safari".
-    headless:  The original headless mode for Chromium and Firefox.
-    headless2:  Chromium's new headless mode. (Has more features)
-    locale_code:  Set the Language Locale Code for the web browser.
-    protocol:  The Selenium Grid protocol: "http" or "https".
-    servername:  The Selenium Grid server/IP used for tests.
-    port:  The Selenium Grid port used by the test server.
-    proxy:  Use proxy. Format: "SERVER:PORT" or "USER:PASS@SERVER:PORT".
-    proxy_bypass_list:  Skip proxy when using the listed domains.
-    proxy_pac_url:  Use PAC file. (Format: URL or USERNAME:PASSWORD@URL)
-    multi_proxy:  # Allow multiple proxies with auth when multi-threaded.
-    agent:  Modify the web browser's User-Agent string.
-    cap_file:  The desired capabilities to use with a Selenium Grid.
-    cap_string:  The desired capabilities to use with a Selenium Grid.
-    recorder_ext:  Enables the SeleniumBase Recorder Chromium extension.
-    disable_js:  Disable JavaScript on websites. Pages might break!
-    disable_csp:  Disable the Content Security Policy of websites.
-    enable_ws:  Enable Web Security on Chromium-based browsers.
-    enable_sync:  Enable "Chrome Sync" on websites.
-    use_auto_ext:  Use Chrome's automation extension.
-    undetectable:  Use undetected-chromedriver to evade bot-detection.
-    uc_cdp_events:  Capture CDP events in undetected-chromedriver mode.
-    uc_subprocess:  Use undetected-chromedriver as a subprocess.
-    log_cdp_events:  Capture {"performance": "ALL", "browser": "ALL"}
-    incognito:  Enable Chromium's Incognito mode.
-    guest_mode:  Enable Chromium's Guest mode.
-    dark_mode:  Enable Chromium's Dark mode.
-    devtools:  Open Chromium's DevTools when the browser opens.
-    remote_debug:  Enable Chrome's Debugger on "http://localhost:9222".
-    enable_3d_apis:  Enable WebGL and 3D APIs.
-    swiftshader:  Chrome: --use-gl=angle / --use-angle=swiftshader-webgl
-    ad_block_on:  Block some types of display ads from loading.
-    host_resolver_rules:  Set host-resolver-rules, comma-separated.
-    block_images:  Block images from loading during tests.
-    do_not_track:  Tell websites that you don't want to be tracked.
-    chromium_arg:  "ARG=N,ARG2" (Set Chromium args, ","-separated.)
-    firefox_arg:  "ARG=N,ARG2" (Set Firefox args, comma-separated.)
-    firefox_pref:  SET (Set Firefox PREFERENCE:VALUE set, ","-separated)
-    user_data_dir:  Set the Chrome user data directory to use.
-    extension_zip:  Load a Chrome Extension .zip|.crx, comma-separated.
-    extension_dir:  Load a Chrome Extension directory, comma-separated.
-    disable_features:  "F1,F2" (Disable Chrome features, ","-separated.)
-    binary_location:  Set path of the Chromium browser binary to use.
-    driver_version:  Set the chromedriver or uc_driver version to use.
-    skip_js_waits:  Skip JS Waits (readyState=="complete" and Angular).
-    wait_for_angularjs:  Wait for AngularJS to load after some actions.
-    use_wire:  Use selenium-wire's webdriver over selenium webdriver.
-    external_pdf:  Set Chrome "plugins.always_open_pdf_externally":True.
-    window_position:  Set the browser's starting window position: "X,Y"
-    window_size:  Set the browser's starting window size: "Width,Height"
-    is_mobile:  Use the mobile device emulator while running tests.
-    mobile:  Shortcut / Duplicate of "is_mobile".
-    device_metrics:  Set mobile metrics: "CSSWidth,CSSHeight,PixelRatio"
-    xvfb:  Run tests using the Xvfb virtual display server on Linux OS.
-    xvfb_metrics:  Set Xvfb display size on Linux: "Width,Height".
-    start_page:  The starting URL for the web browser when tests begin.
-    rec_print:  If Recorder is enabled, prints output after tests end.
-    rec_behave:  Like Recorder Mode, but also generates behave-gherkin.
-    record_sleep:  If Recorder enabled, also records self.sleep calls.
-    data:  Extra test data. Access with "self.data" in tests.
-    var1:  Extra test data. Access with "self.var1" in tests.
-    var2:  Extra test data. Access with "self.var2" in tests.
-    var3:  Extra test data. Access with "self.var3" in tests.
-    variables:  DICT (Extra test data. Access with "self.variables")
-    account:  Set account. Access with "self.account" in tests.
-    environment:  Set the test env. Access with "self.env" in tests.
-    headed:  Run tests in headed/GUI mode on Linux, where not default.
-    maximize:  Start tests with the browser window maximized.
-    disable_ws:  Reverse of "enable_ws". (None and False are different)
-    disable_beforeunload:  Disable the "beforeunload" event on Chromium.
-    settings_file:  A file for overriding default SeleniumBase settings.
-    uc:  Shortcut / Duplicate of "undetectable".
-    undetected:  Shortcut / Duplicate of "undetectable".
-    uc_cdp:  Shortcut / Duplicate of "uc_cdp_events".
-    uc_sub:  Shortcut / Duplicate of "uc_subprocess".
-    log_cdp:  Shortcut / Duplicate of "log_cdp_events".
-    ad_block:  Shortcut / Duplicate of "ad_block_on".
-    server:  Shortcut / Duplicate of "servername".
-    guest:  Shortcut / Duplicate of "guest_mode".
-    wire:  Shortcut / Duplicate of "use_wire".
-    pls:  Shortcut / Duplicate of "page_load_strategy".
-    sjw:  Shortcut / Duplicate of "skip_js_waits".
-    wfa:  Shortcut / Duplicate of "wait_for_angularjs".
-    save_screenshot:  Save a screenshot at the end of each test.
-    no_screenshot:  No screenshots saved unless tests directly ask it.
-    page_load_strategy:  Set Chrome PLS to "normal", "eager", or "none".
-    timeout_multiplier:  Multiplies the default timeout values.
-    js_checking_on:  Check for JavaScript errors after page loads.
-    slow:  Slow down the automation. Faster than using Demo Mode.
-    demo:  Slow down and visually see test actions as they occur.
-    demo_sleep:  SECONDS (Set wait time after Slow & Demo Mode actions.)
-    message_duration:  SECONDS (The time length for Messenger alerts.)
-    highlights:  Number of highlight animations for Demo Mode actions.
-    interval:  SECONDS (Autoplay interval for SB Slides & Tour steps.)
-    time_limit:  SECONDS (Safely fail tests that exceed the time limit.)
+    test (bool):  Test Mode: Output, Logging, Continue on failure unless "rtf".
+    rtf (bool):  Shortcut / Duplicate of "raise_test_failure".
+    raise_test_failure (bool):  If "test" mode, raise Exception on 1st failure.
+    browser (str):  Choose from "chrome", "edge", "firefox", or "safari".
+    headless (bool):  Use the default headless mode for Chromium and Firefox.
+    headless1 (bool):  Use Chromium's old headless mode. (Fast, but limited)
+    headless2 (bool):  Use Chromium's new headless mode. (Has more features)
+    locale_code (str):  Set the Language Locale Code for the web browser.
+    protocol (str):  The Selenium Grid protocol: "http" or "https".
+    servername (str):  The Selenium Grid server/IP used for tests.
+    port (int):  The Selenium Grid port used by the test server.
+    proxy (str):  Use proxy. Format: "SERVER:PORT" or "USER:PASS@SERVER:PORT".
+    proxy_bypass_list (str):  Skip proxy when using the listed domains.
+    proxy_pac_url (str):  Use PAC file. (Format: URL or USERNAME:PASSWORD@URL)
+    multi_proxy (bool):  # Allow multiple proxies with auth when multithreaded.
+    agent (str):  Modify the web browser's User-Agent string.
+    cap_file (str):  The desired capabilities to use with a Selenium Grid.
+    cap_string (str):  The desired capabilities to use with a Selenium Grid.
+    recorder_ext (bool):  Enables the SeleniumBase Recorder Chromium extension.
+    disable_js (bool):  Disable JavaScript on websites. Pages might break!
+    disable_csp (bool):  Disable the Content Security Policy of websites.
+    enable_ws (bool):  Enable Web Security on Chromium-based browsers.
+    enable_sync (bool):  Enable "Chrome Sync" on websites.
+    use_auto_ext (bool):  Use Chrome's automation extension.
+    undetectable (bool):  Use undetected-chromedriver to evade bot-detection.
+    uc_cdp_events (bool):  Capture CDP events in undetected-chromedriver mode.
+    uc_subprocess (bool):  Use undetected-chromedriver as a subprocess.
+    log_cdp_events (bool):  Capture {"performance": "ALL", "browser": "ALL"}
+    incognito (bool):  Enable Chromium's Incognito mode.
+    guest_mode (bool):  Enable Chromium's Guest mode.
+    dark_mode (bool):  Enable Chromium's Dark mode.
+    devtools (bool):  Open Chromium's DevTools when the browser opens.
+    remote_debug (bool):  Enable Chrome's Debugger on "http://localhost:9222".
+    enable_3d_apis (bool):  Enable WebGL and 3D APIs.
+    swiftshader (bool):  Chrome: --use-gl=angle / --use-angle=swiftshader-webgl
+    ad_block_on (bool):  Block some types of display ads from loading.
+    host_resolver_rules (str):  Set host-resolver-rules, comma-separated.
+    block_images (bool):  Block images from loading during tests.
+    do_not_track (bool):  Tell websites that you don't want to be tracked.
+    chromium_arg (str):  "ARG=N,ARG2" (Set Chromium args, ","-separated.)
+    firefox_arg (str):  "ARG=N,ARG2" (Set Firefox args, comma-separated.)
+    firefox_pref (str):  SET (Set Firefox PREFERENCE:VALUE set, ","-separated)
+    user_data_dir (str):  Set the Chrome user data directory to use.
+    extension_zip (str):  Load a Chrome Extension .zip|.crx, comma-separated.
+    extension_dir (str):  Load a Chrome Extension directory, comma-separated.
+    disable_features (str):  "F1,F2" (Disable Chrome features, ","-separated.)
+    binary_location (str):  Set path of the Chromium browser binary to use.
+    driver_version (str):  Set the chromedriver or uc_driver version to use.
+    skip_js_waits (bool):  Skip JS Waits (readyState=="complete" and Angular).
+    wait_for_angularjs (bool):  Wait for AngularJS to load after some actions.
+    use_wire (bool):  Use selenium-wire's webdriver over selenium webdriver.
+    external_pdf (bool):  Set Chrome "plugins.always_open_pdf_externally":True.
+    window_position (x,y):  Set the browser's starting window position: "X,Y"
+    window_size (w,h):  Set the browser's starting window size: "Width,Height"
+    is_mobile (bool):  Use the mobile device emulator while running tests.
+    mobile (bool):  Shortcut / Duplicate of "is_mobile".
+    device_metrics (w,h,pr):  Mobile metrics: "CSSWidth,CSSHeight,PixelRatio"
+    xvfb (bool):  Run tests using the Xvfb virtual display server on Linux OS.
+    xvfb_metrics (w,h):  Set Xvfb display size on Linux: "Width,Height".
+    start_page (str):  The starting URL for the web browser when tests begin.
+    rec_print (bool):  If Recorder is enabled, prints output after tests end.
+    rec_behave (bool):  Like Recorder Mode, but also generates behave-gherkin.
+    record_sleep (bool):  If Recorder enabled, also records self.sleep calls.
+    data (str):  Extra test data. Access with "self.data" in tests.
+    var1 (str):  Extra test data. Access with "self.var1" in tests.
+    var2 (str):  Extra test data. Access with "self.var2" in tests.
+    var3 (str):  Extra test data. Access with "self.var3" in tests.
+    variables (dict):  Extra test data. Access with "self.variables".
+    account (str):  Set account. Access with "self.account" in tests.
+    environment (str):  Set the test env. Access with "self.env" in tests.
+    headed (bool):  Run tests in headed/GUI mode on Linux, where not default.
+    maximize (bool):  Start tests with the browser window maximized.
+    disable_ws (bool):  Reverse of "enable_ws". (None and False are different)
+    disable_beforeunload (bool):  Disable the "beforeunload" event on Chromium.
+    settings_file (str):  A file for overriding default SeleniumBase settings.
+    uc (bool):  Shortcut / Duplicate of "undetectable".
+    undetected (bool):  Shortcut / Duplicate of "undetectable".
+    uc_cdp (bool):  Shortcut / Duplicate of "uc_cdp_events".
+    uc_sub (bool):  Shortcut / Duplicate of "uc_subprocess".
+    log_cdp (bool):  Shortcut / Duplicate of "log_cdp_events".
+    ad_block (bool):  Shortcut / Duplicate of "ad_block_on".
+    server (str):  Shortcut / Duplicate of "servername".
+    guest (bool):  Shortcut / Duplicate of "guest_mode".
+    wire (bool):  Shortcut / Duplicate of "use_wire".
+    pls (str):  Shortcut / Duplicate of "page_load_strategy".
+    sjw (bool):  Shortcut / Duplicate of "skip_js_waits".
+    wfa (bool):  Shortcut / Duplicate of "wait_for_angularjs".
+    save_screenshot (bool):  Save a screenshot at the end of each test.
+    no_screenshot (bool):  No screenshots saved unless tests directly ask it.
+    page_load_strategy (str):  Set Chrome PLS to "normal", "eager", or "none".
+    timeout_multiplier (float):  Multiplies the default timeout values.
+    js_checking_on (bool):  Check for JavaScript errors after page loads.
+    slow (bool):  Slow down the automation. Faster than using Demo Mode.
+    demo (bool):  Slow down and visually see test actions as they occur.
+    demo_sleep (float):  SECONDS (Set wait time after Slow & Demo Mode actions)
+    message_duration (float):  SECONDS (The time length for Messenger alerts.)
+    highlights (int):  Number of highlight animations for Demo Mode actions.
+    interval (float):  SECONDS (Autoplay interval for SB Slides & Tour steps.)
+    time_limit (float):  SECONDS (Safely fail tests that exceed the time limit)
     """
     import os
     import sys
@@ -401,6 +403,13 @@ def SB(
             headless = True
         else:
             headless = False
+    if headless1 is None:
+        if "--headless1" in sys_argv:
+            headless1 = True
+        else:
+            headless1 = False
+    if headless1:
+        headless = True
     if headless2 is None:
         if "--headless2" in sys_argv:
             headless2 = True
@@ -672,6 +681,7 @@ def SB(
         recorder_ext = True
     if recorder_mode and headless:
         headless = False
+        headless1 = False
         headless2 = True
     sb_config.proxy_driver = False
     if "--proxy-driver" in sys_argv or "--proxy_driver" in sys_argv:
@@ -801,6 +811,7 @@ def SB(
         save_screenshot = False  # "no_screenshot" has priority
     if browser == "safari" and headless:
         headless = False  # Safari doesn't support headless mode
+        headless1 = False
     if js_checking_on is None:
         if "--check-js" in sys_argv:
             js_checking_on = True
@@ -921,6 +932,7 @@ def SB(
         sb_config.is_nosetest = False
     sb_config.is_context_manager = True
     sb_config.headless = headless
+    sb_config.headless1 = headless1
     sb_config.headless2 = headless2
     sb_config.headed = headed
     sb_config.xvfb = xvfb
@@ -1026,6 +1038,7 @@ def SB(
     sb.is_nosetest = False
     sb.is_context_manager = sb_config.is_context_manager
     sb.headless = sb_config.headless
+    sb.headless1 = sb_config.headless1
     sb.headless2 = sb_config.headless2
     sb.headed = sb_config.headed
     sb.xvfb = sb_config.xvfb

seleniumbase/plugins/selenium_plugin.py

@@ -43,8 +43,9 @@ class SeleniumBrowser(Plugin):
     --sjw  (Skip JS Waits for readyState to be "complete" or Angular to load.)
     --wfa  (Wait for AngularJS to be done loading after specific web actions.)
     --pls=PLS  (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
-    --headless  (Run tests in headless mode. The default arg on Linux OS.)
-    --headless2  (Use the new headless mode, which supports extensions.)
+    --headless  (The default headless mode. Linux uses this mode by default.)
+    --headless1  (Use Chrome's old headless mode. Fast, but has limitations.)
+    --headless2  (Use Chrome's new headless mode, which supports extensions.)
     --headed  (Run tests in headed/GUI mode on Linux OS, where not default.)
     --xvfb  (Run tests using the Xvfb virtual display server on Linux OS.)
     --xvfb-metrics=STRING  (Set Xvfb display size on Linux: "Width,Height".)
@@ -437,6 +438,15 @@ class SeleniumBrowser(Plugin):
                 UNLESS using a virtual display with Xvfb.
                 Default: False on Mac/Windows. True on Linux.""",
         )
+        parser.addoption(
+            "--headless1",
+            action="store_true",
+            dest="headless1",
+            default=False,
+            help="""This option activates the old headless mode,
+                    which is faster, but has limitations.
+                    (May be phased out by Chrome in the future.)""",
+        )
         parser.addoption(
             "--headless2",
             action="store_true",
@@ -1009,6 +1019,7 @@ class SeleniumBrowser(Plugin):
         browser = self.options.browser
         test.test.browser = browser
         test.test.headless = None
+        test.test.headless1 = None
         test.test.headless2 = None
         # As a shortcut, you can use "--edge" instead of "--browser=edge", etc,
         # but you can only specify one default browser. (Default: chrome)
@@ -1147,9 +1158,13 @@ class SeleniumBrowser(Plugin):
         test.test.cap_file = self.options.cap_file
         test.test.cap_string = self.options.cap_string
         test.test.headless = self.options.headless
+        test.test.headless1 = self.options.headless1
+        if test.test.headless1:
+            test.test.headless = True
         test.test.headless2 = self.options.headless2
         if test.test.headless and test.test.browser == "safari":
             test.test.headless = False  # Safari doesn't use headless
+            test.test.headless1 = False
         if test.test.headless2 and test.test.browser == "firefox":
             test.test.headless2 = False  # Only for Chromium browsers
             test.test.headless = True  # Firefox has regular headless
@@ -1294,8 +1309,10 @@ class SeleniumBrowser(Plugin):
         # Recorder Mode can still optimize scripts in --headless2 mode.
         if self.options.recorder_mode and self.options.headless:
             self.options.headless = False
+            self.options.headless1 = False
             self.options.headless2 = True
             test.test.headless = False
+            test.test.headless1 = False
             test.test.headless2 = True
         if not self.options.headless and not self.options.headless2:
             self.options.headed = True

{seleniumbase-4.31.0.dist-info → seleniumbase-4.31.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: seleniumbase
-Version: 4.31.0
+Version: 4.31.1
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -821,8 +821,9 @@ pytest test_coffee_cart.py --trace
 --sjw  # (Skip JS Waits for readyState to be "complete" or Angular to load.)
 --wfa  # (Wait for AngularJS to be done loading after specific web actions.)
 --pls=PLS  # (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
---headless  # (Run tests in headless mode. The default arg on Linux OS.)
---headless2  # (Use the new headless mode, which supports extensions.)
+--headless  # (The default headless mode. Linux uses this mode by default.)
+--headless1  # (Use Chrome's old headless mode. Fast, but has limitations.)
+--headless2  # (Use Chrome's new headless mode, which supports extensions.)
 --headed  # (Run tests in headed/GUI mode on Linux OS, where not default.)
 --xvfb  # (Run tests using the Xvfb virtual display server on Linux OS.)
 --xvfb-metrics=STRING  # (Set Xvfb display size on Linux: "Width,Height".)

{seleniumbase-4.31.0.dist-info → seleniumbase-4.31.1.dist-info}/RECORD

@@ -3,10 +3,10 @@ sbase/__main__.py,sha256=G0bVB1-DM4PGwQ1KyOupaWCs4ePbChZNNWuX2htim5U,647
 sbase/steps.py,sha256=bKT_u5bJkKzYWEuAXi9NVVRYYxQRCM1_YJUrNFFRVPY,42865
 seleniumbase/__init__.py,sha256=pXetYtgSNEM2KRcZedpSSqE52Kr3spkOD6DjZO1Wsu4,2236
 seleniumbase/__main__.py,sha256=dn1p6dgCchmcH1zzTzzQvFwwdQQqnTGH6ULV9m4hv24,654
-seleniumbase/__version__.py,sha256=pqpXGIksdOnytIY3oWL5AUa-pfVc42jPohuIpus0T9U,46
+seleniumbase/__version__.py,sha256=ZPjiQBuD0UdNKlKtSQnk1zCFPlVf6h5pTkS742IHrJc,46
 seleniumbase/behave/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 seleniumbase/behave/behave_helper.py,sha256=elkl8P9eLulRAioLstE9baYNM9N_PHBmAOcajX-pH_Y,24198
-seleniumbase/behave/behave_sb.py,sha256=1-SDxXx9EQSMztCUda3KDO5rfwmfWthKmwWFiFyiTow,58844
+seleniumbase/behave/behave_sb.py,sha256=B8v7bR4Kie0RRYph9i43OT3PHhHent_hhB6uQUzVZ0I,59189
 seleniumbase/behave/steps.py,sha256=8-N-NB2tnDsxaP4LSg-uSBgbwZYMS6ZEL1oggO1PCoU,390
 seleniumbase/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 seleniumbase/common/decorators.py,sha256=LJnAgg0RG3kDOFb8tpyq1zjmpv9ks6Tjg8GwgIn1YuY,7633
@@ -19,9 +19,9 @@ seleniumbase/config/ad_block_list.py,sha256=qCQvbpONdSXk6q5tMwLuOswGYE1Syd8cy5TM
 seleniumbase/config/proxy_list.py,sha256=tSdk82_6pPqClotHMl3YOTlxi9IIEppHmCoQDkZXLqw,1123
 seleniumbase/config/settings.py,sha256=cAMmoFBQ6g8GCJIsRsSwGsP1_fJxhADxjHq30lFB18g,7815
 seleniumbase/console_scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-seleniumbase/console_scripts/logo_helper.py,sha256=F8pcANlWY6pdcMwHUdjjpjAD9i8XD0R5J-28eSh7QMM,1907
+seleniumbase/console_scripts/logo_helper.py,sha256=GoCH_tTSPd-oGAacgFPpKw0MnJ3_i9eacxXdJMwNoH8,3136
 seleniumbase/console_scripts/rich_helper.py,sha256=U_zvXpalxVV8rtg8c8EnNNmnh45tii3AV5ZV3O3KbGA,2234
-seleniumbase/console_scripts/run.py,sha256=H7sWc5Bni_RTk4rWqiLZ6b1lhHnKjfVZjy1xYehl2YE,59327
+seleniumbase/console_scripts/run.py,sha256=bc4yk6NgMVVVD2ca6XsmL_4hmpOz6AS4MrTAV1gTgCk,59354
 seleniumbase/console_scripts/sb_behave_gui.py,sha256=Sm8OVgq1SJ6F-8Dl-xflglEmOpNJn4C_-ZPuHRiZvTM,15375
 seleniumbase/console_scripts/sb_caseplans.py,sha256=77Ocuok2v36x7i1Qmp6sGSdDf3H5y6gPB5QtxHHcjgo,18373
 seleniumbase/console_scripts/sb_commander.py,sha256=SNBOApj4JV_jtdoV7WPFVSWhFqLkPWOpFB8KPKYufGU,13557
@@ -36,7 +36,7 @@ seleniumbase/console_scripts/sb_print.py,sha256=yo641b_OdSE0GUauOyxk-QrNeIjYzbRY
 seleniumbase/console_scripts/sb_recorder.py,sha256=QazacANTQgoc76abAfFUV0d4ja1o-bbsoX9sTPZr_eg,11134
 seleniumbase/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 seleniumbase/core/application_manager.py,sha256=e_0sjtI8cjY5BNyZj1QBR0j6_oCScxGmSXYEpcYwuZE,576
-seleniumbase/core/browser_launcher.py,sha256=r-95DrVNk5TEnX0wKAIzR-aau6XskVNujF3OMWYisk8,203405
+seleniumbase/core/browser_launcher.py,sha256=udC8RtY7E6rcw5m5zkrpQZLtyz5yXFiwL7hmub8Iw5g,204822
 seleniumbase/core/capabilities_parser.py,sha256=meIS2uHapTCq2ldfNAToC7r0cKmZDRXuYNKExM1GHDY,6038
 seleniumbase/core/colored_traceback.py,sha256=DrRWfg7XEnKcgY59Xj7Jdk09H-XqHYBSUpB-DiZt6iY,2020
 seleniumbase/core/create_db_tables.sql,sha256=VWPtrdiW_HQ6yETHjqTu-VIrTwvd8I8o1NfBeaVSHpU,972
@@ -50,7 +50,7 @@ seleniumbase/core/proxy_helper.py,sha256=cXhu8ErK9Vjdm82RMaQj7hEq_yUWizSp6LyiD50
 seleniumbase/core/recorder_helper.py,sha256=fNGjbapXmEsht54x1o6Igk198QdnPxDDnjUOzQxNhNQ,25055
 seleniumbase/core/report_helper.py,sha256=AIl6Qava2yW1uSzbLpJBlPlYDz0KE-rVhogh8hsGWBo,12201
 seleniumbase/core/s3_manager.py,sha256=bkeI8I4y19ebWuQG1oEZV5qJbotC6eN8vin31OCNWJk,3521
-seleniumbase/core/sb_driver.py,sha256=zIC0kvVmZM6ZNeYd4Hvd6iuh95rxsuipIXE6P5UacIY,9745
+seleniumbase/core/sb_driver.py,sha256=_oC9esOgxhKXssMEzS-3gfNuqevJSr8eZ39ClL4ZuSk,10037
 seleniumbase/core/session_helper.py,sha256=s9zD3PVZEWVzG2h81cCUskbNWLfdjC_LwwQjKptHCak,558
 seleniumbase/core/settings_parser.py,sha256=KokVXpCiGZhJ-D4Bo-hizPz5r-iefzWoiTANu9zNaq4,7504
 seleniumbase/core/style_sheet.py,sha256=tPpJ1xl6Kuw425Z-3Y0OgVRLGXk_ciBDREZjXk_NuPE,11395
@@ -64,13 +64,13 @@ seleniumbase/extensions/disable_csp.zip,sha256=YMifIIgEBiLrEFrS1sfW4Exh4br1V4oK1
 seleniumbase/extensions/recorder.zip,sha256=OOyzF-Ize2cSRu1CqhzSAq5vusI9hqLLd2OIApUHesI,11918
 seleniumbase/extensions/sbase_ext.zip,sha256=3s1N8zrVaMz8RQEOIoBzC3KDjtmHwVZRvVsX25Odr_s,8175
 seleniumbase/fixtures/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-seleniumbase/fixtures/base_case.py,sha256=fhr7e79Ofovb6Ib-iTaDeEsWB-XtBitu85a0gkpfz58,701811
+seleniumbase/fixtures/base_case.py,sha256=Rz0gC0gAse85jcV4iiY_fxLaoq6-QJTcUAVNk7DVOhM,702330
 seleniumbase/fixtures/constants.py,sha256=TapuGLdERtvZPGMblVXkNGybr8tj8FMtN3sbJ3ygyoc,13569
 seleniumbase/fixtures/css_to_xpath.py,sha256=9ouDB1xl4MJ2os6JOgTIAyHKOQfuxtxvXC3O5hSnEKA,1954
 seleniumbase/fixtures/errors.py,sha256=KyxuEVx_e3MPhVrJfNIa_3ltMpbCFxfy_jxK8RFNTns,555
 seleniumbase/fixtures/js_utils.py,sha256=cYFRazc6iO2tTB5kf3_mW3czMQ8mJ5OSHldx7n31E8E,50940
 seleniumbase/fixtures/page_actions.py,sha256=5xYWeTDLs9i1yOs5iWDk17CLoiUU5kRLHlmKRUJ7TcQ,63030
-seleniumbase/fixtures/page_utils.py,sha256=NY1B6b_C6cwxLkKM1SHXfadDEcTH80fXGAatfAyiLSc,11986
+seleniumbase/fixtures/page_utils.py,sha256=5m7iXpikLs80TJoRO6_gEfXE1AKeQgcH1aFbR8o1C9A,12034
 seleniumbase/fixtures/shared_utils.py,sha256=Fc78v0OxfLPOPqeT8ExsdkTgXHlmpxvJeLbLyDnu1dI,5748
 seleniumbase/fixtures/unittest_helper.py,sha256=sfZ92rZeBAn_sF_yQ3I6_I7h3lyU5-cV_UMegBNoEm8,1294
 seleniumbase/fixtures/words.py,sha256=FOA4mAYvl3EPVpBTvgvK6YwCL8BdlRCmed685kEe7Vg,7827
@@ -85,13 +85,13 @@ seleniumbase/plugins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hS
 seleniumbase/plugins/base_plugin.py,sha256=FemdftNhOaTfQIw5bWcJQPPPGQ3P0_sMEI_YYDuzZgU,14972
 seleniumbase/plugins/basic_test_info.py,sha256=8ov6n417gPbqqvrlT4zrch7l2XcRt-GF2ny6rR9AMWk,2108
 seleniumbase/plugins/db_reporting_plugin.py,sha256=En09qUCoojrk9-vbcnsoHdSELoGmag2GDIyu3jTiJas,7331
-seleniumbase/plugins/driver_manager.py,sha256=LOt9sD06KD4ghMBgSDkIscBmbnWoiHgJmkcdFXsdWxA,32647
+seleniumbase/plugins/driver_manager.py,sha256=Rs2UE1yv5Npcdev7F4nwhQoTD25MpNYDINe7H0luyfY,33361
 seleniumbase/plugins/page_source.py,sha256=loTnXxOj4kxEukuTZEiGyvKBhY3KDVDMnNlHHheTBDE,1889
-seleniumbase/plugins/pytest_plugin.py,sha256=U-FVZkR2V3WGv_27Hvqk7Atse0HA49hT9wfr7-Ipqu8,96521
+seleniumbase/plugins/pytest_plugin.py,sha256=1NTzVJOd6zMvq16lPQHglfdguU3C0tj94FY6DZNZUBU,97106
 seleniumbase/plugins/s3_logging_plugin.py,sha256=WDfertQgGOW_SRJpFMaekYD6vBVW9VO62POtXXy2HCM,2319
-seleniumbase/plugins/sb_manager.py,sha256=nvp37M_P1ky1Wxl05PaRdFefnScWLr9njXnYYaN01LI,51898
+seleniumbase/plugins/sb_manager.py,sha256=g5woe7oYYe4Dav50nuIN5RClynrvZ1H8uhxLSyxl9Q4,53016
 seleniumbase/plugins/screen_shots.py,sha256=1hrXw-hzuZ1BR6Yh7AyWX2ABnvnP73-RCbwdz958gj4,1127
-seleniumbase/plugins/selenium_plugin.py,sha256=Ko5QBHVbNa8NOPlibRRgshdl5S0YOKo576pCeFW_qAw,57871
+seleniumbase/plugins/selenium_plugin.py,sha256=yDk-CuyuRiMw3eZlUOWh15d5WtsTex_dhhdMxKUUexg,58583
 seleniumbase/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 seleniumbase/translate/__init__.py,sha256=N2i5XntTwJZmwr9-qvdX5gC6Rdm5-ClIbnQ8yyPn4Oo,459
 seleniumbase/translate/chinese.py,sha256=0QhK2eadtsdN4KCvwki1J7jBCe8I4xxWbKzteJKJozY,24698
@@ -126,9 +126,9 @@ seleniumbase/utilities/selenium_grid/start-grid-hub.bat,sha256=Ftq-GrAKRYH2ssDPr
 seleniumbase/utilities/selenium_grid/start-grid-hub.sh,sha256=KADv0RUHONLL2_I443QFK8PryBpDmKn5Gy0s4o0vDSM,106
 seleniumbase/utilities/selenium_ide/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 seleniumbase/utilities/selenium_ide/convert_ide.py,sha256=pZFnqEJQEKZPyNFjkLD29s2HPQgCrWW9XJWpCPhWOoM,31691
-seleniumbase-4.31.0.dist-info/LICENSE,sha256=odSYtWibXBnQ1gBg6CnDZ82n8kLF_if5-2nbqnEyD8k,1085
-seleniumbase-4.31.0.dist-info/METADATA,sha256=H3_T9Hh20tgyREt7LmP34MsLHYsS-BYgM_knTkVgKho,85160
-seleniumbase-4.31.0.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-seleniumbase-4.31.0.dist-info/entry_points.txt,sha256=CNrh2EKNaHYEhO6pP1RJyVLB99LkDDYX7TnUK8xfjqk,623
-seleniumbase-4.31.0.dist-info/top_level.txt,sha256=4N97aBOQ8ETCnDnokBsWb07lJfTaq3C1ZzYRxvLMxqU,19
-seleniumbase-4.31.0.dist-info/RECORD,,
+seleniumbase-4.31.1.dist-info/LICENSE,sha256=odSYtWibXBnQ1gBg6CnDZ82n8kLF_if5-2nbqnEyD8k,1085
+seleniumbase-4.31.1.dist-info/METADATA,sha256=MShVjw08x3Ga43QfWzUgOWal5fuCx_hMdQuK_rsYEm4,85244
+seleniumbase-4.31.1.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
+seleniumbase-4.31.1.dist-info/entry_points.txt,sha256=CNrh2EKNaHYEhO6pP1RJyVLB99LkDDYX7TnUK8xfjqk,623
+seleniumbase-4.31.1.dist-info/top_level.txt,sha256=4N97aBOQ8ETCnDnokBsWb07lJfTaq3C1ZzYRxvLMxqU,19
+seleniumbase-4.31.1.dist-info/RECORD,,