To create a WebDriver browser instance:
from webdriverplus import WebDriver
browser = WebDriver('firefox')
Currently supported browsers are firefox, chrome, ie and remote.
The default browser is firefox. If called without any arguments, WebDriver() will create a firefox instance.
browser = WebDriver()
Because starting up a web browser instance on every test run can be a significant performance hit, WebDriverPlus provides an easy way to allows instances to be reused between test sessions.
Setting the reuse_browser flag ensures that when you call driver.quit() the browser will be returned to a browser pool, and reused when you create a new WebBrowserInstance:
browser = WebDriver('firefox', reuse_browser=True)
There are some important aspects to bear in mind about this behaviour:
By default WebDriverPlus will ensure that when a python process quits it will attempt to quit any remaining open WebDriver instances.
If you do not want this behaviour set quit_on_exit to False:
browser = WebDriver('firefox', quit_on_exit=False)
To quit a WebDriver broswer instance, call quit():
browser.quit()
Setting the force flag causes the browser instance to quit and ignore the value of the reuse_browser flag. The instance will be terminated and will not be returned to the browser pool:
browser.quit(force=True)