• Many SeleniumBase "tests" run with pytest.
• Chrome is the default browser if not specified.
• Tests are structured using 25 unique design patterns.
• Logs from test failures are saved to ./latest_logs/.
• Tests can be run with multiple command-line options.
• Examples can be found in SeleniumBase/examples/.
• Stealthy CDP Mode examples: SeleniumBase/examples/cdp_mode/.
• Stealthy Playwright examples: ./examples/cdp_mode/playwright/.

(NOTE: Some example tests fail on purpose to demonstrate logging features.)

Run an example test: (Default option: --chrome)

pytest my_first_test.py

Here's one way of changing the browser to Firefox:

pytest my_first_test.py --firefox

Another example test for a web page that has lots of different HTML items:

pytest test_demo_site.py

Run an example test in --demo mode: (highlight assertions)

pytest test_swag_labs.py --demo

Run test_coffee_cart.py to test the Coffee Cart app:

pytest test_coffee_cart.py --demo

You can debug tests easily with the included pdbp (Pdb+) debugger:

pytest test_coffee_cart.py --trace

Run a Wordle-solver example:

pytest wordle_test.py

Run an example test in --headless mode: (invisible browser)

pytest my_first_test.py --headless

Run an example test using Chrome's mobile device emulator: (default settings)

pytest test_swag_labs.py --mobile

Run an example test in --demo mode: (highlight assertions)

pytest test_xkcd.py --demo

Run a test suite with verbose output: (see more details)

pytest test_suite.py -v

Run a test suite using multiple parallel processes (-n=NUM):

pytest test_suite.py -n=8

Run a parameterized test: (Generates multiple tests from one)

pytest parameterized_test.py -v

Run a test suite and generate a SeleniumBase Dashboard:

pytest test_suite.py --dashboard

Run a test suite and generate a pytest report:

pytest test_suite.py --html=report.html

Run a failing test: (See the latest_logs/ folder for logs and screenshots)

pytest test_fail.py

Run a failing test that activates pdb debug mode on failure:

pytest test_fail.py --pdb -s

(pdb commands: n, c, s, u, d => next, continue, step, up, down)

Run a test suite that demonstrates the use of pytest markers:

pytest -m marker_test_suite -v

Run a test suite that reuses the browser session between tests:

pytest test_suite.py --rs

Run an example test demonstrating the rate_limited Python decorator:

pytest rate_limiting_test.py

Run an example test that demonstrates how to upload a file to a website:

pytest upload_file_test.py

🎖️ SeleniumBase Commander is a GUI for pytest:

sbase gui

SeleniumBase tests can also be run with pynose:

pynose my_first_test.py

Run an example test suite and generate a pynose test report:

pynose test_suite.py --report --show-report

Run an example test using a pynose configuration file:

pynose my_first_test.py --config=example_config.cfg

For more advanced run commands, such as using a proxy server, see ../help_docs/customizing_test_runs.md

If you just need to perform some quick website verification on various devices, you can use the SeleniumBase Device Farm. Just plug in a website URL, and it will display how the website looks on four different devices:

To make things easier, here's a simple GUI program that allows you to run a few example tests by pressing a button:

python gui_test_runner.py

(The newer SeleniumBase Commander improves on that.)

Ask questions. Find answers. Learn how to automate!