Update the docs

Author: mdmintz

README.md

@@ -357,6 +357,7 @@ The code above will leave your browser window open in case there's a failure. (i
 --agent=STRING  # (Modify the web browser's User-Agent string.)
 --mobile  # (Use the mobile device emulator while running tests.)
 --metrics=STRING  # (Set mobile metrics: "CSSWidth,CSSHeight,PixelRatio".)
+--chromium-arg=ARG  # (Add a Chromium arg for Chrome/Edge, comma-separated.)
 --extension-zip=ZIP  # (Load a Chrome Extension .zip|.crx, comma-separated.)
 --extension-dir=DIR  # (Load a Chrome Extension directory, comma-separated.)
 --headless  # (Run tests headlessly. Default mode on Linux OS.)

help_docs/customizing_test_runs.md

@@ -109,8 +109,10 @@ SeleniumBase provides additional ``pytest`` command-line options for tests:
 --port=PORT  # (The Selenium Grid port used by the test server.)
 --proxy=SERVER:PORT  # (Connect to a proxy server:port for tests.)
 --proxy=USERNAME:PASSWORD@SERVER:PORT  # (Use authenticated proxy server.)
+--agent=STRING  # (Modify the web browser's User-Agent string.)
 --mobile  # (Use the mobile device emulator while running tests.)
 --metrics=STRING  # (Set mobile metrics: "CSSWidth,CSSHeight,PixelRatio".)
+--chromium-arg=ARG  # (Add a Chromium arg for Chrome/Edge, comma-separated.)
 --extension-zip=ZIP  # (Load a Chrome Extension .zip|.crx, comma-separated.)
 --extension-dir=DIR  # (Load a Chrome Extension directory, comma-separated.)
 --headless  # (Run tests headlessly. Default mode on Linux OS.)

help_docs/shadow_dom.md

@@ -0,0 +1,23 @@
+## Shadow DOM support / Shadow-root interaction
+
+🔵 SeleniumBase lets you pierce through open Shadow DOM selectors (to interact with elements inside) by adding ``::shadow`` to CSS fragments that include a shadow-root element. For multi-layered shadow-roots, you must individually pierce through each shadow-root element that you want to get through.
+
+🔵 Here are some examples of Shadow DOM selectors:
+
+```python
+css_1 = "downloads-manager::shadow #no-downloads"
+
+css_2 = "downloads-manager::shadow #downloadsList downloads-item::shadow #file-link"
+
+css_3 = "downloads-manager::shadow downloads-toolbar::shadow cr-toolbar::shadow cr-toolbar-search-field::shadow cr-icon-button"
+
+css_4 = "downloads-manager::shadow downloads-toolbar::shadow cr-toolbar::shadow cr-toolbar-search-field::shadow #searchInput"
+
+css_5 = "downloads-manager::shadow downloads-toolbar::shadow cr-toolbar::shadow cr-toolbar-search-field::shadow #clearSearch"
+```
+
+🔵 The shadow-root (``::shadow``) elements are transitional, and therefore cannot be the final part of your CSS selectors. Complete your CSS selectors by including an element that's inside a shadow-root.
+
+🔵 Note that ``::shadow`` selectors only exist within SeleniumBase, and do not exist outside of it.
+
+🔵 Here's an example test that interacts with Shadow DOM elements: [examples/test_shadow_dom.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_shadow_dom.py)

mkdocs.yml

@@ -114,6 +114,7 @@ nav:
     - Desired Capabilities: help_docs/desired_capabilities.md
     - Docker Start Guide: integrations/docker/ReadMe.md
     - Using Safari Driver: help_docs/using_safari_driver.md
+    - Shadow DOM Support: help_docs/shadow_dom.md
     - macOS Hidden Files: help_docs/hidden_files_info.md
     - MySQL Instructions: help_docs/mysql_installation.md
   - Demo Pages: