Welcome to behave-webdriver’s documentation!

behave-webdriver

behave-webdriver is a step library intended to allow users to easily run browser automation tests (via selenium) with the behave BDD testing framework.

Inspired by, the webdriverio cucumber-boilerplate project.

• Installation
  • Using webdrivers
• Quickstart
  • Importing the step implementations
  • Set behave_driver in the environment
  • Writing the feature file
  • Run behave
• behave-webdriver API Reference
  • The webdriver classes
  • The BehaveDriverMixin
• List of predefined steps
  • Given Steps 👷
  • When Steps ▶️
  • Then Steps ✔️
• Advanced usage; extending behave-webdriver
  • Example: selenium-requests
• Browser Support
  • Chrome (recommended)
  • Firefox (beta)
  • Ie
  • Safari
  • PhantomJS
  • Remote
  • Edge
  • Opera
  • BlackBerry
  • Android
• Roadmap
  • Immediate and Short Term
  • Medium Term
  • Long Term, ongoing, and Ideas
  • Completed
  • Deferred

Indices and tables

• Index
• Module Index
• Search Page

Goals

• Make writing readable browser automation tests as Gherkin features easy.
• Provide an easily extensible interface to the selenium driver (BehaveDriver)
• To be (at least mostly) compatible with feature files written for webdriverio/cucumber-boilerplate

Status

We currently test against Python2.7 and Python3.5+ using headless chrome. While all selenium’s webdrivers are provided, they are not all supported at this time. We plan to add support for additional browsers in the future.