Chrome WebDriver


To use the Chrome driver, pass the string chrome when you create the Browser instance:

from splinter import Browser
browser = Browser('chrome')

Note: if you don’t provide any driver to the Browser function, firefox will be used.

Note: if you have trouble with $HOME/.bash_profile, you can try $HOME/.bashrc.

Emulation mode

Chrome options can be passed to customize Chrome’s behaviour; it is then possible to leverage the experimental emulation mode.

Further Information: chrome driver documentation

from selenium import webdriver
from splinter import Browser

mobile_emulation = {"deviceName": "Google Nexus 5"}
chrome_options = webdriver.ChromeOptions()
  "mobileEmulation", mobile_emulation,
browser = Browser('chrome', options=chrome_options)


Selenium uses the Service class to manage chromedriver. An instance of this class can be given directly to Splinter.

from splinter import Browser
from import Service

my_service = Service()
browser = Browser('chrome', service=my_service)

Custom executable path

The Service object can be used to specify the path to chromedriver. For example:

from splinter import Browser
from import Service

my_service = Service(executable_path='</path/to/chromedriver>')
browser = Browser('chrome', service=my_service)

API docs