selenium.webdriver.common.desired_capabilities

The Desired Capabilities implementation.

Classes

DesiredCapabilities()

Set of default supported desired capabilities.

class selenium.webdriver.common.desired_capabilities.DesiredCapabilities

Set of default supported desired capabilities.

Use this as a starting point for creating a desired capabilities object for requesting remote webdrivers for connecting to selenium server or selenium grid.

Usage Example:

from selenium import webdriver

selenium_grid_url = "http://198.0.0.1:4444/wd/hub"

# Create a desired capabilities object as a starting point.
capabilities = DesiredCapabilities.FIREFOX.copy()
capabilities['platform'] = "WINDOWS"
capabilities['version'] = "10"

# Instantiate an instance of Remote WebDriver with the desired capabilities.
driver = webdriver.Remote(desired_capabilities=capabilities,
                          command_executor=selenium_grid_url)

Note: Always use ‘.copy()’ on the DesiredCapabilities object to avoid the side effects of altering the Global class instance.

FIREFOX = {'acceptInsecureCerts': True, 'browserName': 'firefox', 'moz:debuggerAddress': True}

INTERNETEXPLORER = {'browserName': 'internet explorer', 'platformName': 'windows'}

EDGE = {'browserName': 'MicrosoftEdge'}

CHROME = {'browserName': 'chrome'}

SAFARI = {'browserName': 'safari', 'platformName': 'mac'}

HTMLUNIT = {'browserName': 'htmlunit', 'platform': 'ANY', 'version': ''}

HTMLUNITWITHJS = {'browserName': 'htmlunit', 'javascriptEnabled': True, 'platform': 'ANY', 'version': 'firefox'}

IPHONE = {'browserName': 'iPhone', 'platform': 'mac', 'version': ''}

IPAD = {'browserName': 'iPad', 'platform': 'mac', 'version': ''}

WEBKITGTK = {'browserName': 'MiniBrowser'}

WPEWEBKIT = {'browserName': 'MiniBrowser'}