Page Load Strategy#

Class to configure page load strategy that is then passed on to the underlying Selenium web driver.

Strategy Options#

Option	Description	Ready State
`PageLoadStrategy.NORMAL`	Default. Waits for all resources to download.	Complete
`PageLoadStrategy.EAGER`	DOM access is ready, but other resources like images may still be loading.	Interactive
`PageLoadStrategy.NONE`	Does not block web driver at all.	Any

Note

The page load strategy is set for the entire browser session. It can't be changed later for individual functions.

Example#

How to set the page load strategy when opening a new browser:

Python
from browserist import Browser, BrowserSettings, PageLoadStrategy

settings = BrowserSettings(page_load_strategy=PageLoadStrategy.EAGER)

with Browser(settings) as browser:
    browser.open.url("https://example.com")

Details on Document Ready State#

The document.readyState is a property of the DOM that indicates the loading status of the page. When navigating to a new page via URL, the browser driver waits until the document ready state is complete by default.

Note that this doesn't mean that the page has finished loading. This is especially the case for single-page applications that use JavaScript to dynamically load content after the document ready state is complete. Furthermore, the behavior does not apply to navigation that is a result of clicking an element or submitting a form.

If a page takes a long time to load as a result of downloading assets (e.g. images, CSS, JavaScript) that aren't important to the automation, you can change from the default PageLoadStrategy.NORMAL to PageLoadStrategy.EAGER or PageLoadStrategy.NONE to speed up the session.

Warning

Though you may gain some performance by using either PageLoadStrategy.NONE or PageLoadStrategy.EAGER, it's usually not recommended. The browser may not be ready to execute the next function, which can lead to unstability. It's often better to use PageLoadStrategy.NORMAL and, if the browser allows it, disable images instead.