To use splinter you need create a Browser instance:

from splinter import Browser
browser = Browser()

Or, you can use it by a context manager, through the with statement:

from splinter import Browser
with Browser() as b:
    # stuff using the browser

This last example will create a new browser window and close it when the cursor reach the code outside the with statement, automatically.

splinter support three drivers: chrome, firefox and zopetestbrowser

browser = Browser('chrome')
browser = Browser('firefox')
browser = Browser('zope.testbrowser')

Managing Windows

You can manage multiple windows (such as popups) through the windows object:              # all open windows[0]           # the first window[window_name] # the window_name window      # the current window =[3]  # set current window to window 3

window =[0]
window.is_current            # boolean - whether window is current active window
window.is_current = True     # set this window to be current window                  # the next window
window.prev                  # the previous window
window.close()               # close this window
window.close_others()        # close all windows except this one

This window management interface is not compatible with the undocumented interface exposed in v0.6.0 and earlier.

Reload a page

You can reload a page using reload method:



You can get the title of the visited page using the title attribute:


Verifying page content with Browser.html

You can use the html attribute to get the html content of the visited page:


Verifying page url with Browser.url

The visited page’s url can be accessed by the url attribute:


Changing Browser User-Agent

You can pass User-Agent on Browser instantiation.

b = Browser(user_agent="Mozilla/5.0 (iPhone; U; CPU like Mac OS X; en)")