[{"_1":2,"_160":-5,"_161":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_139":140},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_128":-5,"_129":11,"_130":21,"_131":11,"_132":-5,"_133":11,"_134":-5,"_135":136,"_137":91,"_138":-7},"canonicalUrl","https://hub.docker.com/r/bukowa/seleniumbase/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","bukowa","reponame","seleniumbase","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":74,"_79":11,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2021-03-22T20:13:12.171926Z","description","","is_private","last_updated","2021-03-22T20:22:27.172548Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56],"application/vnd.docker.container.image.v1+json","name","pull_count",1617,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","\n\n\n\n\n\n\n

\nA complete end-to-end testing experience.\n

\n\n\n

\n $\"SeleniumBase$ $\"SeleniumBase$ \n $\"SeleniumBase\"$ $\"Stargazers\"$ \n $\"SeleniumBase.io$

\n\n

\nSeleniumBase is an all-in-one Python framework for automated browser testing.\nTests are run with \"pytest\", and use WebDriver APIs for web-page interaction.\n

\n\n

\n\n✅ Simple setup steps with [Python](https://www.python.org/downloads/) and [Git](https://git-scm.com/).
\n✅ Chrome/Edge/Firefox/IE/Opera/Safari.
\n✅ Includes [reporting and dashboard tools](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/example_logs/ReadMe.md).\n\n--------\n\n

Example: my_first_test.py (--demo mode)

\n\n```bash\npytest my_first_test.py --demo\n```\n\n

$\"SeleniumBase$

\n\n```python\nfrom seleniumbase import BaseCase\n\nclass MyTestClass(BaseCase):\n\n def test_basics(self):\n url = \"https://store.xkcd.com/collections/posters\"\n self.open(url)\n self.type('input[name=\"q\"]', \"xkcd book\")\n self.click('input[value=\"Search\"]')\n self.assert_text(\"xkcd: volume 0\", \"h3\")\n self.open(\"https://xkcd.com/353/\")\n self.assert_title(\"xkcd: Python\")\n self.assert_element('img[alt=\"Python\"]')\n self.click('a[rel=\"license\"]')\n self.assert_text(\"free to copy and reuse\")\n self.go_back()\n self.click_link(\"About\")\n self.assert_exact_text(\"xkcd.com\", \"h2\")\n```\n\n--------\n\n\n

$\"SeleniumBase\"$ Python Setup:

\n\n🔵 Add **[Python](https://www.python.org/downloads/)** and **[Git](https://git-scm.com/)** to your System PATH.\n\n🔵 Create a **[Python virtual environment](https://seleniumbase.io/help_docs/virtualenv_instructions/)**.\n\n\n

$\"SeleniumBase\"$ Install SeleniumBase:

\n\n🔵 You can install ``seleniumbase`` from [GitHub](https://github.com/seleniumbase/SeleniumBase):\n\n```bash\ngit clone https://github.com/seleniumbase/SeleniumBase.git\ncd SeleniumBase/\npip install . # Normal installation\npip install -e . # Editable install\n```\n\n> (When using a virtual env, the Editable install is faster.)\n\n🔵 You can also install ``seleniumbase`` from [pypi](https://pypi.python.org/pypi/seleniumbase):\n\n```bash\npip install seleniumbase\n```\n\n> (Add ``--upgrade`` OR ``-U`` to upgrade an installation.)\n> (Add ``--force-reinstall`` to upgrade dependencies.)\n> (Use ``pip3`` if multiple versions of Python are installed.)\n\n🔵 Type ``seleniumbase`` or ``sbase`` to verify that SeleniumBase was installed successfully:\n\n```bash\n ______ __ _ ____ \n / ____/__ / /__ ____ (_)_ ______ ___ / _ \\____ ________ \n \\__ \\/ _ \\/ / _ \\/ __ \\/ / / / / __ `__ \\/ /_) / __ \\/ ___/ _ \\\n ___/ / __/ / __/ / / / / /_/ / / / / / / /_) / (_/ /__ / __/\n/____/\\___/_/\\___/_/ /_/_/\\__,_/_/ /_/ /_/_____/\\__,_/____/\\___/ \n-----------------------------------------------------------------\n\n * USAGE: \"seleniumbase [COMMAND] [PARAMETERS]\"\n * OR: \"sbase [COMMAND] [PARAMETERS]\"\n\nCOMMANDS:\n install [DRIVER] [OPTIONS]\n methods (List common Python methods)\n options (List common pytest options)\n mkdir [DIRECTORY] [OPTIONS]\n mkfile [FILE.py] [OPTIONS]\n mkpres [FILE.py] [LANG]\n print [FILE] [OPTIONS]\n translate [SB_FILE.py] [LANG] [ACTION]\n convert [WEBDRIVER_UNITTEST_FILE.py]\n extract-objects [SB_FILE.py]\n inject-objects [SB_FILE.py] [OPTIONS]\n objectify [SB_FILE.py] [OPTIONS]\n revert-objects [SB_FILE.py] [OPTIONS]\n encrypt (OR: obfuscate)\n decrypt (OR: unobfuscate)\n download server (The Selenium Grid JAR file)\n grid-hub [start|stop] [OPTIONS]\n grid-node [start|stop] --hub=[HOST/IP]\n * (EXAMPLE: \"sbase install chromedriver latest\") *\n\n Type \"sbase help [COMMAND]\" for specific command info.\n For info on all commands, type: \"seleniumbase --help\".\n * (Use \"pytest\" for running tests) *\n```\n\n

$\"SeleniumBase\"$ Download a webdriver:

\n\n✅ SeleniumBase can download webdrivers to the [seleniumbase/drivers](https://github.com/seleniumbase/SeleniumBase/tree/master/seleniumbase/drivers) folder with the ``install`` command:\n\n```bash\nsbase install chromedriver\n```\n\n* You need a different webdriver for each browser to automate: ``chromedriver`` for Chrome, ``edgedriver`` for Edge, ``geckodriver`` for Firefox, and ``operadriver`` for Opera.\n* If you have the latest version of Chrome installed, get the latest chromedriver (otherwise it defaults to chromedriver 2.44 for compatibility reasons):\n\n```bash\nsbase install chromedriver latest\n```\n\n* If you run a test without the correct webdriver installed, the driver will be downloaded automatically.\n\n(See [seleniumbase.io/seleniumbase/console_scripts/ReadMe/](https://seleniumbase.io/seleniumbase/console_scripts/ReadMe/) for more information on SeleniumBase console scripts.)\n\n

$\"SeleniumBase\"$ Running tests:

\n\n🔵 If you've cloned SeleniumBase from GitHub, you can run sample tests from the [examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder:\n\n```bash\ncd examples/\npytest test_demo_site.py\n```\n\n> (Chrome is the default browser if not specified with ``--browser=BROWSER``. On Linux, ``--headless`` is the default behavior. You can also run in headless mode on any OS. If your Linux machine has a GUI and you want to see the web browser as tests run, add ``--headed`` or ``--gui``.)\n\n $\"SeleniumBase$
\n\n🔵 Here are more examples that you can run:\n\n```bash\npytest my_first_test.py\n\npytest test_swag_labs.py\n```\n\n🔵 Run [my_first_test.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py) in Demo Mode:\n\n```bash\npytest my_first_test.py --demo\n```\n\n $\"SeleniumBase$ \n\n* By default, **[CSS Selectors](https://www.w3schools.com/cssref/css_selectors.asp)** are used for finding page elements.\n* If you're new to CSS Selectors, games like [Flukeout](http://flukeout.github.io/) can help you learn.\n* Here are some common ``SeleniumBase`` methods that you might find in tests:\n\n```python\nself.open(URL) # Navigate to the web page\nself.click(SELECTOR) # Click a page element\nself.type(SELECTOR, TEXT) # Type text (Add \"\\n\" to text for pressing enter/return.)\nself.assert_element(SELECTOR) # Assert element is visible\nself.assert_text(TEXT) # Assert text is visible (has optional SELECTOR arg)\nself.assert_title(PAGE_TITLE) # Assert page title\nself.assert_no_404_errors() # Assert no 404 errors from files on the page\nself.assert_no_js_errors() # Assert no JavaScript errors on the page (Chrome-ONLY)\nself.execute_script(JAVASCRIPT) # Execute JavaScript code\nself.go_back() # Navigate to the previous URL\nself.get_text(SELECTOR) # Get text from a selector\nself.get_attribute(SELECTOR, ATTRIBUTE) # Get a specific attribute from a selector\nself.is_element_visible(SELECTOR) # Determine if an element is visible on the page\nself.is_text_visible(TEXT) # Determine if text is visible on the page (optional SELECTOR)\nself.hover_and_click(HOVER_SELECTOR, CLICK_SELECTOR) # Mouseover element & click another\nself.select_option_by_text(DROPDOWN_SELECTOR, OPTION_TEXT) # Select a dropdown option\nself.switch_to_frame(FRAME_NAME) # Switch webdriver control to an iframe on the page\nself.switch_to_default_content() # Switch webdriver control out of the current iframe\nself.switch_to_window(WINDOW_NUMBER) # Switch to a different window/tab\nself.save_screenshot(FILE_NAME) # Save a screenshot of the current page\n```\n\n🔵 For the complete list of SeleniumBase methods, see: Method Summary\n\n

$\"SeleniumBase\"$ Learn More:

\n\n✅ Automatic WebDriver Abilities:\n

SeleniumBase automatically handles common WebDriver actions such as spinning up web browsers and saving screenshots during test failures. (Read more about customizing test runs.)

\n\n✅ Simplified Code:\n

SeleniumBase uses simple syntax for commands. Example:

\n\n```python\nself.type(\"input\", \"dogs\\n\")\n```\n\nSeleniumBase tests can be run with both ``pytest`` and ``nosetests``, but using ``pytest`` is recommended. (``chrome`` is the default browser if not specified.)\n\n```bash\npytest my_first_test.py --browser=chrome\n\nnosetests test_suite.py --browser=firefox\n```\n\n✅ Automatic Test Discovery:\n

All Python methods that start with test_ will automatically be run when using pytest or nosetests on a Python file, (or on folders containing Python files). You can also be more specific on what to run within a file by using the following: (Note that the syntax is different for pytest vs nosetests.)

\n\n```bash\npytest [FILE_NAME.py]::[CLASS_NAME]::[METHOD_NAME]\n\nnosetests [FILE_NAME.py]:[CLASS_NAME].[METHOD_NAME]\n```\n\n✅ No More Flaky Tests:\n

SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (up to a timeout limit). This means you no longer need random time.sleep() statements in your scripts.

\n $\"NO$ \n\n✅ Automated/Manual Hybrid Mode:\n

SeleniumBase includes a solution called MasterQA, which speeds up manual testing by having automation perform all the browser actions while the manual tester handles validation.

\n\n✅ Feature-Rich:\n

For a full list of SeleniumBase features, Click Here.

\n\n\n\n $\"SeleniumBase\"$ \n\n

$\"SeleniumBase\"$ Detailed Instructions:

\n\n Use Demo Mode to help you see what tests are asserting.\n\n🔵 If the example test is moving too fast for your eyes, you can run it in **Demo Mode** by adding ``--demo`` on the command-line, which pauses the browser briefly between actions, highlights page elements being acted on, and lets you know what test assertions are happening in real time:\n\n```bash\npytest my_first_test.py --demo\n```\n\n🔵 ``Pytest`` includes test discovery. If you don't specify a specific file or folder to run from, ``pytest`` will search all subdirectories automatically for tests to run based on the following matching criteria:\nPython filenames that start with ``test_`` or end with ``_test.py``.\nPython methods that start with ``test_``.\nThe Python class name can be anything since SeleniumBase's ``BaseCase`` class inherits from the ``unittest.TestCase`` class.\nYou can see which tests are getting discovered by ``pytest`` by using:\n\n```bash\npytest --collect-only -q\n```\n\n🔵 You can use the following calls in your scripts to help you debug issues:\n\n```python\nimport time; time.sleep(5) # Makes the test wait and do nothing for 5 seconds.\nimport ipdb; ipdb.set_trace() # Enter debugging mode. n = next, c = continue, s = step.\nimport pytest; pytest.set_trace() # Enter debugging mode. n = next, c = continue, s = step.\n```\n\n🔵 To pause an active test that throws an exception or error, add ``--pdb``:\n\n```bash\npytest my_first_test.py --pdb\n```\n\nThe code above will leave your browser window open in case there's a failure. (ipdb commands: 'n', 'c', 's' => next, continue, step).\n\n🔵 Here are some useful command-line options that come with ``pytest``:\n\n```bash\n-v # Verbose mode. Prints the full name of each test run.\n-q # Quiet mode. Print fewer details in the console output when running tests.\n-x # Stop running the tests after the first failure is reached.\n--html=report.html # Creates a detailed pytest-html report after tests finish.\n--collect-only | --co # Show what tests would get run. (Without running them)\n-n=NUM # Multithread the tests using that many threads. (Speed up test runs!)\n-s # See print statements. (Should be on by default with pytest.ini present.)\n--junit-xml=report.xml # Creates a junit-xml report after tests finish.\n--pdb # If a test fails, pause run and enter debug mode. (Don't use with CI!)\n-m=MARKER # Run tests with the specified pytest marker.\n```\n\n🔵 SeleniumBase provides additional ``pytest`` command-line options for tests:\n\n```bash\n--browser=BROWSER # (The web browser to use. Default: \"chrome\".)\n--chrome # (Shortcut for \"--browser=chrome\". On by default.)\n--edge # (Shortcut for \"--browser=edge\".)\n--firefox # (Shortcut for \"--browser=firefox\".)\n--opera # (Shortcut for \"--browser=opera\".)\n--safari # (Shortcut for \"--browser=safari\".)\n--cap-file=FILE # (The web browser's desired capabilities to use.)\n--cap-string=STRING # (The web browser's desired capabilities to use.)\n--settings-file=FILE # (Override default SeleniumBase settings.)\n--env=ENV # (Set a test environment. Use \"self.env\" to use this in tests.)\n--data=DATA # (Extra test data. Access with \"self.data\" in tests.)\n--var1=DATA # (Extra test data. Access with \"self.var1\" in tests.)\n--var2=DATA # (Extra test data. Access with \"self.var2\" in tests.)\n--var3=DATA # (Extra test data. Access with \"self.var3\" in tests.)\n--user-data-dir=DIR # (Set the Chrome user data directory to use.)\n--server=SERVER # (The Selenium Grid server/IP used for tests.)\n--port=PORT # (The Selenium Grid port used by the test server.)\n--proxy=SERVER:PORT # (Connect to a proxy server:port for tests.)\n--proxy=USERNAME:PASSWORD@SERVER:PORT # (Use authenticated proxy server.)\n--agent=STRING # (Modify the web browser's User-Agent string.)\n--mobile # (Use the mobile device emulator while running tests.)\n--metrics=STRING # (Set mobile metrics: \"CSSWidth,CSSHeight,PixelRatio\".)\n--extension-zip=ZIP # (Load a Chrome Extension .zip|.crx, comma-separated.)\n--extension-dir=DIR # (Load a Chrome Extension directory, comma-separated.)\n--headless # (Run tests headlessly. Default mode on Linux OS.)\n--headed # (Run tests with a GUI on Linux OS.)\n--locale=LOCALE_CODE # (Set the Language Locale Code for the web browser.)\n--interval=SECONDS # (The autoplay interval for presentations & tour steps)\n--start-page=URL # (The starting URL for the web browser when tests begin.)\n--archive-logs # (Archive existing log files instead of deleting them.)\n--archive-downloads # (Archive old downloads instead of deleting them.)\n--time-limit=SECONDS # (Safely fail any test that exceeds the time limit.)\n--slow # (Slow down the automation. Faster than using Demo Mode.)\n--demo # (Slow down and visually see test actions as they occur.)\n--demo-sleep=SECONDS # (Set the wait time after Demo Mode actions.)\n--highlights=NUM # (Number of highlight animations for Demo Mode actions.)\n--message-duration=SECONDS # (The time length for Messenger alerts.)\n--check-js # (Check for JavaScript errors after page loads.)\n--ad-block # (Block some types of display ads after page loads.)\n--block-images # (Block images from loading during tests.)\n--verify-delay=SECONDS # (The delay before MasterQA verification checks.)\n--disable-csp # (Disable the Content Security Policy of websites.)\n--disable-ws # (Disable Web Security on Chromium-based browsers.)\n--enable-ws # (Enable Web Security on Chromium-based browsers.)\n--enable-sync # (Enable \"Chrome Sync\".)\n--use-auto-ext # (Use Chrome's automation extension.)\n--remote-debug # (Enable Chrome's Remote Debugger on http://localhost:9222)\n--dashboard # (Enable the SeleniumBase Dashboard. Saved at: dashboard.html)\n--swiftshader # (Use Chrome's \"--use-gl=swiftshader\" feature.)\n--incognito # (Enable Chrome's Incognito mode.)\n--guest # (Enable Chrome's Guest mode.)\n--devtools # (Open Chrome's DevTools when the browser opens.)\n--reuse-session | --rs # (Reuse browser session between tests.)\n--crumbs # (Delete all cookies between tests reusing a session.)\n--maximize-window # (Start tests with the web browser window maximized.)\n--save-screenshot # (Save a screenshot at the end of each test.)\n--visual-baseline # (Set the visual baseline for Visual/Layout tests.)\n--timeout-multiplier=MULTIPLIER # (Multiplies the default timeout values.)\n```\n\n(For more details, see the full list of command-line options **[here](https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/plugins/pytest_plugin.py)**.)\n\n🔵 During test failures, logs and screenshots from the most recent test run will get saved to the ``latest_logs/`` folder. Those logs will get moved to ``archived_logs/`` if you add --archive_logs to command-line options, or have ARCHIVE_EXISTING_LOGS set to True in [settings.py](https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/config/settings.py), otherwise log files with be cleaned up at the start of the next test run. The ``test_suite.py`` collection contains tests that fail on purpose so that you can see how logging works.\n\n```bash\ncd examples/\n\npytest test_suite.py --browser=chrome\n\npytest test_suite.py --browser=firefox\n```\n\nAn easy way to override seleniumbase/config/settings.py is by using a custom settings file.\nHere's the command-line option to add to tests: (See [examples/custom_settings.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/custom_settings.py))\n``--settings_file=custom_settings.py``\n(Settings include default timeout values, a two-factor auth key, DB credentials, S3 credentials, and other important settings used by tests.)\n\n🔵 To pass additional data from the command-line to tests, add ``--data=\"ANY STRING\"``.\nInside your tests, you can use ``self.data`` to access that.\n\n\n

$\"SeleniumBase\"$ Test Directory Configuration:

\n\n🔵 When running tests with **pytest**, you'll want a copy of **[pytest.ini](https://github.com/seleniumbase/SeleniumBase/blob/master/pytest.ini)** in your root folders. When running tests with **nosetests**, you'll want a copy of **[setup.cfg](https://github.com/seleniumbase/SeleniumBase/blob/master/setup.cfg)** in your root folders. These files specify default configuration details for tests. Folders should also include a blank ``__init__.py`` file, which allows your tests to import files from that folder.\n\n🔵 ``sbase mkdir DIR`` creates a folder with config files and sample tests:\n\n```bash\nsbase mkdir ui_tests\n```\n\n> That new folder will have these files:\n\n```bash\nui_tests/\n│\n├── __init__.py\n├── my_first_test.py\n├── parameterized_test.py\n├── pytest.ini\n├── requirements.txt\n├── setup.cfg\n├── test_demo_site.py\n└── boilerplates/\n │\n ├── __init__.py\n ├── base_test_case.py\n ├── boilerplate_test.py\n ├── classic_obj_test.py\n ├── page_objects.py\n ├── sb_fixture_test.py\n └── samples/\n │\n ├── __init__.py\n ├── google_objects.py\n ├── google_test.py\n └── swag_labs_test.py\n```\n\nProTip™: You can also create a boilerplate folder without any sample tests in it by adding ``-b`` or ``--basic`` to the ``sbase mkdir`` command:\n\n```bash\nsbase mkdir ui_tests --basic\n```\n\n> That new folder will have these files:\n\n","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",601859109,"orgData","recentTags",[91],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_50":117,"_118":94,"_119":33,"_120":56,"_57":121,"_122":123,"_124":108,"_125":117,"_126":66,"_127":21},"content_type","creator",12088331,"full_size",601840290,"id",142510591,"images",[101],{"_102":103,"_104":105,"_106":48,"_107":108,"_109":110,"_111":112,"_113":48,"_114":-5,"_115":96,"_63":66,"_116":-5},"architecture","amd64","digest","sha256:e9cc0890e1e3b6e98f16eb02e3cc11742da424b469f5b88680a2c625c4fce744","features","last_pulled","2026-10-12T04:28:18.288400752Z","last_pushed","2021-03-22T20:22:27Z","os","linux","os_features","os_version","size","variant","2021-03-22T20:22:26.81144Z","last_updater","last_updater_username","media_type","latest","repository",11906662,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":141,"_148":149,"_135":158,"_159":11},{"_40":142,"_42":143,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":144,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":145,"_79":11,"_80":147,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":146},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_150":64,"_151":-5,"_152":-5,"_153":154},"count","next","previous","results",[155],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":156,"_50":117,"_118":94,"_119":33,"_120":56,"_57":121,"_122":123,"_124":108,"_125":117,"_126":66,"_127":21},[157],{"_102":103,"_104":105,"_106":48,"_107":108,"_109":110,"_111":112,"_113":48,"_114":-5,"_115":96,"_63":66,"_116":-5},[],"canDeleteTags","actionData","errors"]

bukowa/seleniumbase

Tags for bukowa/seleniumbase