Gwen-web

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 setup up drivers or do any selenium 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.

Installation | Getting Started | DSL | Settings | Blog | Wiki | FAQ | Support

Current Status

What's New?

Integrated WebDriverManager now manages all native webdrivers for you
Mobile Emulation
Visual Testing with AppliTools

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

..by writing Gwen Meta features like this..

   Feature: Google search meta

  @StepDef
  Scenario: I have Google in my browser
      Given I start a new browser
       When I navigate to "http://www.google.com"
       Then the page title should be "Google"

  @StepDef
  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>"

  @StepDef
  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

Java SE 8 Runtime Environment
A web browser
Native web driver
- Safari
- Chrome
- IE
- Firefox

Key Features

Automation driven by plain text Gherkin specifications
- See Gwen-Web DSL
Features can execute in batch mode or interactively
Features can execute sequentially or in parallel
Runtime settings
Execution can be data driven (using csv data feeds)
REPL console allows verifying before running
Cross browser support
Remote web driver support
Screenshot capture and slideshow playback
Interchangeable Selenium implementation
Locator Chaining
Headless Browser Execution
Gwen Workspaces for easy and consistent Gwen installation, configuration and execution on any workstation or build server.
Template matching
Drag and Drop
Locator level timeouts
Implicit JavaScript Locators
Running Gwen on BrowserStack
Synchronized StepDef execution
Indexed locators
Hard, soft, and sustained assertion modes
Visual Testing with AppliTools
Mobile Emulation
Integrated WebDriverManager

License

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

Contributions

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.