Fetching contributors…
Cannot retrieve contributors at this time
188 lines (142 sloc) 8.56 KB



A Gwen interpreter that enables teams to quickly automate front end web tests and robotic online processes with Gherkin feature specifications. A web DSL interacts with Selenium under the covers for you so you don't have to do any of that programming or technical development work. It supports all the standard web element locators provided by Selenium and additionally allows you to inject JavaScript in places where dynamically locating web elements or running functions on pages may be necessary.

Current Status

Build Status

What's New?

Why Gwen-web?

So you can drive automation with Gherkin features like this..

   Feature: Google search

  Scenario: Perform a google search
      Given I have Google in my browser
       When I do a search for "Gwen automation"
       Then the first result should open a Gwen page writing Gwen Meta features like this..

   Feature: Google search meta

  Scenario: I have Google in my browser
      Given I start a new browser
       When I navigate to ""
       Then the page title should be "Google"

  Scenario: I do a search for "<query>"
      Given the search field can be located by name "q"
       When I enter "$<query>" in the search field
       Then the page title should contain "$<query>"

  Scenario: the first result should open a Gwen page
      Given the first match can be located by css selector ".r > a"
       When I click the first match
       Then the current URL should contain "gwen-interpreter"

..with no Page Objects or Selenium coding required!


Runtime Requirements

Key Features

Quick Links to Wiki Information

User Community

All announcements and discussions are posted and broadcast to all members in the Gwen mail group. Active users who join the group will also receive an invitation to our Gwen Slack community where they can interact with other users and help each other out.


Copyright 2014-2018 Brady Wood, Branko Juric and Gwen contributors.

This software is open sourced under the Apache License, Version 2.0.

See also: LICENSE.

This project has dependencies on gwen and other open source projects. All distributed third party dependencies and their licenses are listed in the LICENSE-THIRDPARTY file.

Open sourced 28 June 2014 03:27 pm AEST


New capabilities, improvements, and fixes are all valid candidates for contribution. Submissions can be made using pull requests. Each submission is reviewed and verified by the project maintainers before being integrated and released to the community. We ask that all code submissions include unit tests or sample test features providing relevant coverage.

By submitting contributions, you agree to release your work under the license that covers this software.

How to Contribute

  1. Fork this repository
  2. Create a branch on your forked repository
  3. Commit your changes to your branch
  4. Push your branch to your forked repository
  5. Create a pull request from your branch to here



We thank the following contributors and active users for helping to make Gwen better. You are all awesome!

The following contributors submitted pull requests that have been merged:

The following users raised issues or requests that have been addressed:


Known Users