Update the documentation

Author: mdmintz

Diff for: README.md

@@ -19,30 +19,30 @@
 <p align="center">
 <a href="#python_installation">🚀 Start</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/features_list.md">🏰 Features</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">📚 Examples</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/customizing_test_runs.md">🎛️ Options</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">📚 Examples</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/console_scripts/ReadMe.md">🌠 Scripts</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/mobile_testing.md">📱 Mobile</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/method_summary.md">📘 APIs</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md"> 🔡 Formats</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/example_logs/ReadMe.md">📊 Dashboard</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md"> 🔠 Formats</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/recorder_mode.md">🔴 Recorder</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/example_logs/ReadMe.md">📊 Dashboard</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/locale_codes.md">🗾 Locales</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/utilities/selenium_grid/ReadMe.md">🌐 Grid</a>
+<a href="https://seleniumbase.io/devices/?url=seleniumbase.com">💻 Farm</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/commander.md">🎖️ GUI</a> |
 <a href="https://seleniumbase.io/demo_page">📰 TestPage</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/case_plans.md">🗂️ CasePlans</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md">👤 UC Mode</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/ReadMe.md">🧬 Hybrid</a> |
-<a href="https://seleniumbase.io/devices/?url=seleniumbase.com">💻 Farm</a>
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">🐙 CDP Mode</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/utilities/selenium_grid/ReadMe.md">🌐 Grid</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/how_it_works.md">👁️ How</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/migration/raw_selenium">🚝 Migrate</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/boilerplates">♻️ Templates</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/integrations/node_js">🚉 NodeGUI</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/case_plans.md">🗂️ CasePlans</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/boilerplates">♻️ Template</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/ReadMe.md">🧬 Hybrid</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/ReadMe.md">🚎 Tours</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/integrations/github/workflows/ReadMe.md">🤖 CI/CD</a> |

Diff for: help_docs/ReadMe.md

@@ -20,7 +20,7 @@
 <a href="https://seleniumbase.io/help_docs/method_summary/">📘 Methods / APIs</a> |
 <a href="https://seleniumbase.io/examples/tour_examples/ReadMe/">🚎 Tours</a>
 <br />
-<a href="https://seleniumbase.io/help_docs/syntax_formats/">🔡 Syntax Formats</a> |
+<a href="https://seleniumbase.io/help_docs/syntax_formats/">🔠 Syntax Formats</a> |
 <a href="https://seleniumbase.io/integrations/github/workflows/ReadMe/">🤖 CI/CD</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/boilerplates">♻️ Boilerplates</a> |
@@ -40,6 +40,8 @@
 <br / >
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/commander.md">🎖️ GUI</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md">👤 UC Mode</a>
+<br / >
+<a href="https://seleniumbase.io/examples/cdp_mode/ReadMe/">🐙 CDP Mode</a>
 </p>
 
 --------

Diff for: help_docs/customizing_test_runs.md

@@ -2,16 +2,16 @@
 
 ## [<img src="https://seleniumbase.github.io/img/logo6.png" title="SeleniumBase" width="32">](https://github.com/seleniumbase/SeleniumBase/) pytest options for SeleniumBase
 
-🎛️ SeleniumBase's [pytest plugin](https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/plugins/pytest_plugin.py) lets you customize test runs from the CLI (Command-Line Interface), which adds options for setting/enabling the browser type, Dashboard Mode, Demo Mode, Headless Mode, Mobile Mode, Multi-threading Mode, Recorder Mode, reuse-session mode, proxy config, user agent config, browser extensions, html-report mode, and more.
+🎛️ SeleniumBase's [pytest plugin](https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/plugins/pytest_plugin.py) lets you customize test runs from the CLI (Command-Line Interface), which adds options for setting/enabling the browser type, Dashboard Mode, Demo Mode, Headless Mode, Mobile Mode, Multi-threading Mode, Recorder Mode, UC Mode (stealth), reuse-session mode, Proxy Mode, and more.
 
 🎛️ Here are some examples of configuring tests, which can be run from the [examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder:
 
 ```bash
 # Run a test in Chrome (default browser)
 pytest my_first_test.py
 
-# Run a test in Firefox
-pytest test_swag_labs.py --firefox
+# Run a test in Edge
+pytest test_swag_labs.py --edge
 
 # Run a test in Demo Mode (highlight assertions)
 pytest test_demo_site.py --demo
@@ -31,23 +31,26 @@ pytest test_suite.py --rs --crumbs
 # Create a real-time dashboard for test results
 pytest test_suite.py --dashboard
 
-# Create a pytest html report after tests are done
+# Create a pytest-html report after tests are done
 pytest test_suite.py --html=report.html
 
-# Activate Debug Mode on failures ("c" to continue)
-pytest test_fail.py --pdb -s
-
 # Rerun failing tests more times
 pytest test_suite.py --reruns=1
 
-# Activate Debug Mode as the test begins ("n": next. "c": continue)
+# Activate Debug Mode at the start ("n": next. "c": continue)
 pytest test_null.py --trace -s
 
+# Activate Debug Mode on failures ("n": next. "c": continue)
+pytest test_fail.py --pdb -s
+
+# Activate Debug Mode at the end ("n": next. "c": continue)
+pytest test_fail.py --ftrace -s
+
 # Activate Recorder/Debug Mode as the test begins ("c" to continue)
 pytest test_null.py --recorder --trace -s
 
 # Pass extra data into tests (retrieve by calling self.data)
-pytest my_first_test.py --data="ABC,DEF"
+pytest my_first_test.py --data="ABC"
 
 # Run tests on a local Selenium Grid
 pytest test_suite.py --server="127.0.0.1"
@@ -73,7 +76,7 @@ pytest test_swag_labs.py --mobile
 # Run mobile tests specifying CSS Width, CSS Height, and Pixel-Ratio
 pytest test_swag_labs.py --mobile --metrics="360,640,2"
 
-# Run a test with an option to evade bot-detection services
+# Run tests using UC Mode to evade bot-detection services
 pytest verify_undetected.py --uc
 
 # Run tests while changing SeleniumBase default settings

Diff for: help_docs/locale_codes.md

@@ -2,12 +2,18 @@
 
 ## [<img src="https://seleniumbase.github.io/img/logo6.png" title="SeleniumBase" width="32">](https://github.com/seleniumbase/SeleniumBase/) Language Locale Codes
 
-You can specify a Language Locale Code to customize web pages on supported websites. With SeleniumBase, you can change the web browser's Locale on the command line by doing this:
+You can specify a Language Locale Code to customize web pages on supported websites. With SeleniumBase, you can change the web browser's Locale on the command-line by doing this:
 
 ```bash
 pytest --locale=CODE  # Example: --locale=ru
 ```
 
+From the ``SB()`` and ``Driver()`` formats, you can also set the ``locale_code`` arg like this:
+
+```python
+locale_code="CODE"  # Example: SB(locale_code="en")
+```
+
 <h3><img src="https://seleniumbase.github.io/img/logo6.png" title="SeleniumBase" width="25" /> List of Language Locale Codes:</h3>
 
 <table>

Diff for: help_docs/recorder_mode.md

@@ -59,7 +59,7 @@ sbase recorder
 
 ⏺️ While a recording is in progress, you can press the ``[ESC]`` key to pause the Recorder. To resume the recording, you can hit the ``[~`]`` key, which is located directly below the ``[ESC]`` key on most keyboards.
 
-⏺️ From within Recorder Mode there are two additional modes: "Assert Element Mode" and "Assert Text Mode". To switch into "Assert Element Mode", press the ``[^]-key (SHIFT+6)``: The border will become purple, and you'll be able to click on elements to assert from your test. To switch into "Assert Text Mode", press the ``[&]-key (SHIFT+7)``: The border will become teal, and you'll be able to click on elements for asserting text from your test.
+⏺️ From within Recorder Mode there are two additional modes: "Assert Element Mode" and "Assert Text Mode". To switch into "Assert Element Mode", press the ``[^]-key (SHIFT+6 on standard QWERTY keyboards)``: The border will become purple, and you'll be able to click on elements to assert from your test. To switch into "Assert Text Mode", press the ``[&]-key (SHIFT+7 on standard QWERTY keyboards)``: The border will become teal, and you'll be able to click on elements for asserting text from your test.
 
 ⏺️ While using either of the two special Assertion Modes, certain actions such as clicking on links won't have any effect. This lets you make assertions on elements without navigating away from the page, etc. To add an assertion for buttons without triggering default "click" behavior, mouse-down on the button and then mouse-up somewhere else. (This prevents a detected click while still recording the assert.) To return back to the original Recorder Mode, press any key other than ``[SHIFT]`` or ``[BACKSPACE]`` (Eg: Press ``[CONTROL]``, etc.). Press ``[ESC]`` once to leave the Assertion Modes, but it'll stop the Recorder if you press it again.
 
@@ -123,6 +123,8 @@ pytest TEST_NAME.py --trace --rec -s
 
 ⏺️ By launching the Recorder App with <code>sbase recorder --ee</code>, you can end the recording by pressing {<code>SHIFT</code>+<code>ESC</code>} instead of the usual way of ending the recording by typing <code>c</code> from a <code>breakpoint()</code> and pressing <code>Enter</code>. Those buttons don't need to be pressed at the same time, but <code>SHIFT</code> must be pressed directly before <code>ESC</code>.
 
+⏺️ Use <code>sbase recorder --uc</code> to launch the Recorder App with UC Mode enabled. (The driver will be disconnected from Chrome, but the Recorder extension will still capture any browser actions.)
+
 --------
 
 <div>To learn more about SeleniumBase, check out the Docs Site:</div>

Diff for: help_docs/syntax_formats.md

@@ -4,7 +4,7 @@
 
 <h2><img src="https://seleniumbase.github.io/img/logo6.png" title="SeleniumBase" width="40"> The 23 Syntax Formats / Design Patterns</h2>
 
-<h3>🔡 SeleniumBase supports multiple ways of structuring tests:</h3>
+<h3>🔠 SeleniumBase supports multiple ways of structuring tests:</h3>
 
 <blockquote>
 <p dir="auto"></p>

Diff for: mkdocs.yml

@@ -115,6 +115,7 @@ nav:
     - 🎞️ Presentation Maker: examples/presenter/ReadMe.md
   - Integrations:
     - 👤 UC Mode: help_docs/uc_mode.md
+    - 🐙 CDP Mode: examples/cdp_mode/ReadMe.md
     - 🤖 GitHub CI: integrations/github/workflows/ReadMe.md
     - 🛂 MasterQA: seleniumbase/masterqa/ReadMe.md
     - 🗂️ Case Plans: help_docs/case_plans.md

Diff for: mkdocs_build/requirements.txt

@@ -6,8 +6,8 @@ pymdown-extensions>=10.11.2
 pipdeptree>=2.23.4
 python-dateutil>=2.8.2
 Markdown==3.7
-markdown2==2.5.0
-MarkupSafe==2.1.5
+markdown2==2.5.1
+MarkupSafe==3.0.2
 Jinja2==3.1.4
 click==8.1.7
 ghp-import==2.1.0
@@ -20,7 +20,7 @@ lxml==5.3.0
 pyquery==2.0.1
 readtime==3.0.0
 mkdocs==1.6.1
-mkdocs-material==9.5.39
+mkdocs-material==9.5.42
 mkdocs-exclude-search==0.6.6
 mkdocs-simple-hooks==0.1.5
 mkdocs-material-extensions==1.3.1

Diff for: pyproject.toml

@@ -13,6 +13,7 @@ dynamic = [
     "keywords",
     "classifiers",
     "description",
+    "maintainers",
     "entry-points",
     "dependencies",
     "requires-python",