Browser¶

To use splinter you need to 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 reaches the code outside the with statement, automatically.

splinter supports the following drivers: * Chrome * Firefox * Browsers on remote machines * zope.testbrowser * Django client * Flask client

The following examples create new Browser instances for specific drivers:

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

Navigating with Browser.visit¶

You can use the visit method to navigate to other pages:

browser.visit('http://cobrateam.info')

The visit method takes only a single parameter - the url to be visited.

You can visit a site protected with basic HTTP authentication by providing the username and password in the url.

browser.visit('http://username:password@cobrateam.info/protected')

Managing Windows¶

You can manage multiple windows (such as popups) through the windows object:

browser.windows              # all open windows
browser.windows[0]           # the first window
browser.windows[window_name] # the window_name window
browser.windows.current      # the current window
browser.windows.current = browser.windows[3]  # set current window to window 3

window = browser.windows[0]
window.is_current            # boolean - whether window is current active window
window.is_current = True     # set this window to be current window
window.next                  # 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 the reload method:

browser.reload()

Navigate through the history¶

You can move back and forward through your browsing history using the back and forward methods:

browser.visit('http://cobrateam.info')
browser.visit('https://splinter.readthedocs.io')
browser.back()
browser.forward()

Browser.title¶

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

browser.title

Verifying page content with Browser.html¶

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

browser.html

Verifying page url with Browser.url¶

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

browser.url

Changing Browser User-Agent¶

You can pass a User-Agent header on Browser instantiation.

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