Releases: seleniumbase/SeleniumBase
Fix method that finds all links on a web page
Fix method that finds all links on a web page
- Ignore parsing urls on pages that don't have
://
in the url (ex:about:blank
)
Automated Visual Testing
Automated Visual Testing
- Add
self.check_window(name, level, baseline)
method for automated visual testing - Add methods for processing links and status codes on web pages:
self.get_unique_links()
self.get_link_status_code(link, allow_redirects=False, timeout=5)
self.assert_no_404_errors()
self.print_unique_links_with_status_codes()
- Update pytest versioning
More info on self.check_window(name="default", level=0, baseline=False)
*** Automated Visual Testing with SeleniumBase ***
The first time a test calls self.check_window() for a unique "name"
parameter provided, it will set a visual baseline, meaning that it
creates a folder, saves the URL to a file, saves the current window
screenshot to a file, and creates the following three files
with the listed data saved:
tags_level1.txt -> HTML tags from the window
tags_level2.txt -> HTML tags + attributes from the window
tags_level3.txt -> HTML tags + attributes/values from the window
Baseline folders are named based on the test name and the name
parameter passed to self.check_window(). The same test can store
multiple baseline folders.
If the baseline is being set/reset, the "level" doesn't matter.
After the first run of self.check_window(), it will compare the
HTML tags of the latest window to the one from the initial run.
Here's how the level system works:
* level=0 ->
DRY RUN ONLY - Will perform a comparison to the baseline, and
print out any differences that are found, but
won't fail the test even if differences exist.
* level=1 ->
HTML tags are compared to tags_level1.txt
* level=2 ->
HTML tags are compared to tags_level1.txt and
HTML tags/attributes are compared to tags_level2.txt
* level=3 ->
HTML tags are compared to tags_level1.txt and
HTML tags + attributes are compared to tags_level2.txt and
HTML tags + attributes/values are compared to tags_level3.txt
As shown, Level-3 is the most strict, Level-1 is the least strict.
If the comparisons from the latest window to the existing baseline
don't match, the current test will fail, except for Level-0 tests.
You can reset the visual baseline on the command line by using:
--visual_baseline
As long as "--visual_baseline" is used on the command line while
running tests, the self.check_window() method cannot fail because
it will rebuild the visual baseline rather than comparing the html
tags of the latest run to the existing baseline. If there are any
expected layout changes to a website that you're testing, you'll
need to reset the baseline to prevent unnecessary failures.
self.check_window() will fail with "Page Domain Mismatch Failure"
if the page domain doesn't match the domain of the baseline.
If you want to use self.check_window() to compare a web page to
a later version of itself from within the same test run, you can
add the parameter "baseline=True" to the first time you call
self.check_window() in a test to use that as the baseline. This
only makes sense if you're calling self.check_window() more than
once with the same name parameter in the same test.
Automated Visual Testing with self.check_window() is not very
effective for websites that have dynamic content that changes
the layout and structure of web pages. For those, you're much
better off using regular SeleniumBase functional testing.
Example usage:
self.check_window(name="testing", level=0)
self.check_window(name="xkcd_home", level=1)
self.check_window(name="github_page", level=2)
self.check_window(name="wikipedia_page", level=3)
Add a command-line option to disable the Content Security Policy
Add a command-line option to disable the Content Security Policy.
(The CSP may prevent SeleniumBase custom JavaScript abilities from loading on various web pages.)
Fix browser extension loading for PyPI installations
Fix browser extension loading for PyPI installations:
- Include browser extensions as part of PyPI package data
Update ad-blocker rules
- Update ad-blocker rules
Disable the Content Security Policy of websites by default
Disable the Content Security Policy of websites by default (on Chrome and Firefox)
(If running tests on headless Chrome, the existing Content Security Policy will remain.)
Add methods for setting and removing element attributes
Add methods for setting and removing element attributes:
- Add
self.set_attribute(selector, attribute, value)
- Add
self.remove_attribute(selector, attribute)
Save exported website tours to the "tours_exported" folder
- Save exported website tours to the "tours_exported" folder
- Update tour examples
- Set flake8 version to 3.7.7
Add a command-line option to archive old log files rather than deleting them
Add a command-line option to archive old log files rather than deleting them.
If the option is set, log files from the latest_logs folder will get moved to the archived_logs folder for storage. Otherwise, any existing logs in the latest_logs folder will be deleted at the start of the next test run.
Usage: (on the command line when running tests)
--archive_logs
Add the ability to save screenshots at the end of tests
Add the ability to save screenshots at the end of tests.
This adds the feature for passing tests. (This feature already existed for failing tests automatically.)
Check the latest_logs folder for the images.
Usage: (on the command line when running tests)
--save_screenshot
The screenshot will be taken right before the browser is closed.