Skip to content

Settings Overview#

Options for BrowserSettings#

Use BrowserSettings with the following options:

Setting Option Default Description
type BrowserType BrowserType.CHROME (except BrowserType.EDGE for Windows) Set browser type, e.g. Chrome, Edge, Firefox, etc.
headless True or False False Run the browser in headless mode. May not be supported by all browsers, or some interaction methods, e.g. select, may not be supported.
disable_images True or False False Neither request nor render images, which typically improves loading speed. May not be supported by all browsers.
page_load_strategy PageLoadStrategy PageLoadStrategy.NORMAL Set page load strategy.
path_to_executable Path to file System default If the browser executable isn't in a default folder, select which file to use.
download_dir Path to directory System default Set where to save downloads. Default is the Downloads folder of the user.
screenshot_dir Path to directory System default Set where to save sreenshots. Default is the Downloads folder of the user.
timeout TimeoutSettings TimeoutStrategy.STOP and 5 seconds Set timeout strategy and time.
viewport DeviceViewportSize or (width, height) Browser default size Emulate viewport size as device or set custom value in pixels.
check_connection True or False True Check that there is an internet connection before starting the browser. Bypass the check by setting it to False.

Example#

Python
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
from browserist import Browser, BrowserSettings, BrowserType, common_devices

iphone_se = common_devices.Apple.IPHONE_SE

settings = BrowserSettings(
    type=BrowserType.FIREFOX,
    headless=True,
    disable_images=True,
    viewport=iphone_se)

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