Gauge Framework – How to Perform Test Automation

Bharadwaj Pendyala

Posted On: January 30, 2019

view count47299 Views

Read time13 Min Read

Gauge is a free open source test automation framework released by creators of Selenium, ThoughtWorks. Test automation with Gauge framework is used to create readable and maintainable tests with languages of your choice. Users who are looking for integrating continuous testing pipeline into their CI-CD(Continuous Integration and Continuous Delivery) process for supporting faster release cycles. Gauge framework is gaining the popularity as a great test automation framework for performing cross browser testing.

This article would help you understand the benefits of using the Gauge framework for Selenium test automation, installing and running your first automation script for test automation with Gauge test automation framework. I will also show you how to use LambdaTest Selenium grid for executing your automation script for test automation with Gauge test automation framework to perform extensive, automated browser compatibility testing with Gauge on cloud. Here we go!

If you’re new to Selenium and wondering what it is then we recommend checking out our guide – What is Selenium?

What Is Cross Browser Testing?

Cross Browser Testing is the process to validate the quality of the web application across different browsers, browser versions running on numerous operating systems to verify compatibility and behaviour of an application under test.

The browser differences are induced due to rendering engines. Each browser version has a unique engine responsible for representing the web elements in a different manner.

We have a plethora of platforms, browser, browser versions to test. It would be strenuous and probable infeasible to have all the browsers installed in your local system as you perform test on them one by one. Also, you can’t go ahead having a device lab of your own. So how would you perform cross browser testing in detail?

LambdaTest – A Free Cross Browser Testing Cloud

LambdaTest is a scalable, cloud-based testing platform designed to help you perform browser compatibility testing across 2000+ browsers and browser versions executing on various OS.

LambdaTest can help you with live, interactive, manual cross browser testing as well as automated cross browser testing with the help of the Selenium grid supporting all the major programming languages, automation frameworks compatible with Selenium WebDriver and offers a plethora of browsers to test from.

In order to overcome the manual overhead and time consumed in testing automating the repetitive task would be delightful. And combining your automated tests with Parallel Execution would save a considerable amount of execution time.

Executing a huge number of tests in parallel locally could be a challenge due to resource constraints in terms of scalability. However, you can easily scale with cloud based, cross browser testing tools such as LambdaTest would help you to effortlessly perform parallel execution of your automation test scripts.

Why Choose Gauge For Cross Browser Testing Out Of Other Test Automation Frameworks?

Now, that we are aware of the basics regarding the Gauge framework and cross browser testing. Let me tell you why I prefer to perform test automation with Gauge test automation framework over other test automation frameworks.

  1. Wide range of templates are available in a language of your choice to have an easy kick start to the project.
  2. Command Line support which makes the integration easier with CI-CD tools.
  3. Test automation with Gauge framework supports all major programming languages along with Selenium GoLang.
  4. It supports wide variety of plugins, here is a list of all plugin categories available.
    1. Language Runners: Java runner, C# runner, C# runner(.Net Core), Ruby runner, Javascript runner, Golang runner and Python runner.
    2. IDE Plugins: Visual Studio Code, IntelliJ and Visual Studio.
    3. Reports: HTML Report, XML Report, JSON Report, Spectacle and Flash.
    4. Build Management: Maven and Gradle
    5. You can even create your own plugin using their open source Gauge API.
  5. Quickly detect issues through screenshots of event failures and multiple reporting formats available instead of navigating through stack traces.
  6. Allows you to create scalable tests through parallel execution and being an open-source it offers integrations with cloud-based solutions like LambdaTest for addressing the cross browser testing goals.
  7. Better management of data sets through data driven testing with multiple data sets is possible while keeping specifications highly readable.
  8. Easy to write effective test cases by members across the team.
  9. Automated cross browser testing made easy.
  10. Scalability of product requirements across the QA, Dev and Business teams.


Is Gauge Framework Meant For BDD(Behaviour-Driven Development)?

Users often tend to compare creation of spec files for test automation with Gauge framework is the same way as we develop feature files in BDD using Gherkin, believe me there is a lot of difference in between them.

  • Behaviour Driven Development focuses more on conversations, collaborations and automation in order to achieve the business needs, test automation with Gauge framework following Acceptance Test Driven Development focuses and emphasize more on functional testing.
  • Feature file in BDD is replaced by spec file for test automation with Gauge framework.
  • Feature file is created with Gherkin Language, Spec file is created using markdown language.
  • Test automation with Gauge test automation framework provides templates for automation where BDD doesn’t depending upon the language.

Gauge has all the BDD features intact making BDD a subset of test automation with Gauge framework.

Installing & Setting Up Gauge For Your Operating System

Download the latest build of gauge from GitHub-Gauge. Depending upon the operating system, download the required binaries.

Installing Gauge Framework in Mac:

Installing Gauge framework in macOS using Homebrew with below commands:

  1. brew update
  2. brew install gauge.

Installing Gauge Framework in Linux using apt-get:

  1. Add GPG key with below command:
    sudo apt-key adv --keyserver hkp:// --recv-keys 023EDB0B
  2. Add Gauge framework repository to the list.
    echo deb nightly main | sudo tee -a /etc/apt/sources.list
  3. Install Gauge framework with below commands:
    • sudo apt-get update
    • sudo apt-get install gauge

Installing Gauge Framework in Windows:

Complete the installation of required packages of programming languages. It works with all languages like JavaScript, C#, Java, Python and Ruby.

Extract it to a desired location and add it to system path.

Using CLI To Get Started With Project Creation For Gauge

To verify the version of the Gauge test automation framework, open cmd and type command “gauge --version” as shown in the image below.

Step 1: Gauge framework has a list of project templates defined already for the language of your need. You can take a look at it by typing in command “gauge init --templates”.

Step 2: Navigate to a folder of your choice and create a java project using command “gauge init java”.

Step 3: To run the sample project and view report you can use the command “gauge run specs”.

As you can see the path to report generated in CLI(Command Line Interface), sample report generated for the test stub executed is as below.

Creating Your First Project Using Gauge For Test Automation

As we have made use of command line till now, for a better coding experience we can make use of IntelliJ IDE to create our first script. Start with creating a maven project with below information.

  • Navigate to File and select New Project.
  • Project Type as maven should be selected.
  • You need to select the below mentioned name:
    This would help you to generate an archetype.
  • If you don’t see the archetype mentioned above, add Archetype by entering below info.
    GroupId: “com.thoughtworks.gauge.maven:
    ArtifactId: “gauge-archetype-java
  • After selecting the archetype, you need to click on next. By doing so, you will be providing the Artifact ID & GroupID for your respective maven project.
    GroupId: com.thoughtworks.gauge.maven
    ArtifactId: GoogleSearchProject
    Version: 1.0-SNAPSHOT
  • Before you click on next for finishing the process, make sure that you verify the Maven settings thoroughly.

Once you have successfully created a project it would look something as below.

Running First Automation Script Using Gauge Framework With Selenium Grid

Step 1: Create a specification file for searching a keyword in google and if results are displayed as expected.

Specification heading in the specs file would be denoted with ‘#’ notation as defined in our project.
Example: #Google Search Specification

Scenario would be defined using ‘##’ notation, quoting an example below for reference.
Example: ## Searching google should return the name of the query.

Steps would be defined using ‘*’ notation.
Example: * Navigate to ““. Spec file create for Google search is as below:

# Google Search Specification
## Searching google should return the name of query

  • Navigate to “”
  • Enter query “query” in the search box and submit
  • The search results should show “LambdaTest” as a result

Step 2: Create a step implementation file, with below-mentioned code to define acceptance tests as defined in specification files.

Step 3: Execute the test case from the specification file created. Right click on the file and select option as shown in the image below. Browser specification could be provided in env folder’s file as

#Browser Usage

We can provide maven command to execute with conditions as below.

  1. To execute
    mvn gauge:execute
  2. To execute all specs:
    mvn gauge:execute -DspecsDir=specs
  3. For parallel execution:
    mvn gauge:execute -DspecsDir=specs -DinParallel=true
  4. Node specification during parallel execution:
    mvn gauge:execute -DspecsDir=specs -DinParallel=true -Dnodes=2

Step 4: Once execution has been successfully completed you can verify the status of the test in the terminal.

Reports generated can be viewed in reports folder – ‘GaugeSampleProject\reports\html-report

I would be providing the link to GitHub repository for code references below.

With the above step being done, we have successfully completed installation of Gauge for test automation, creating our first script and running it. Now let’s jump into some of the advanced concepts and values adds which could decrease our execution time drastically for faster releases.

Download Whitepaper

Cross Browser Testing with Parallel Execution using Gauge Framework

Problem Statement:
When it comes to cross browser testing there are more than 6 active browsers usage and each browser having more than 4 to 5 version of it in use aggressively.

Case Study Depiction:
Let’s consider a case study where we have a regression test repository consisting of 1000 test cases to validate per release. When we consider cross browser testing effort, a calculated effort would be around 1000 test cases* 6 browsers * 5 versions each = 30,000 Test Cases.


  1. Local Execution using Selenium-Grid:
    You would end up executing 30,000 test cases in total. Manually handling the effort would be impossible. Parallelly executing the test cases using Selenium Grid might decrease the effort, however, scalability would be an issue, you can’t execute more than 10-20 instances on your local machine depending on the physical memory and the number of cores CPU has. Also, installing thousands of browsers in a system would be very infeasible.
  2. Cloud Execution using LambdaTest:
    Utilizing cloud resources of LambdaTest would drastically cut down the effort as scalability wouldn’t be an issue. LambdaTest Selenium Automation Grid for Gauge empowers you to perform end-to-end automation tests on a secure, reliable, and scalable Selenium grid on their cloud platform. You can perform automated cross browser testing with Selenium scripts on 2000+ browsers and operating systems environments providing a higher test coverage and at significantly fewer build times. LambdaTest will help you evaluate how well your web application renders when accessed through a variety of different browser. You can perform automated cross browser testing of your locally hosted web pages using Lambda Tunnel. You could also perform automated parallel test to run a single test across multiple browser/OS configurations, simultaneously.

Configuring Our Current Gauge Framework For Test Automation With LambdaTest

Step 1: Create an account for free on LambdaTest to start cross browser testing with parallel execution. For a free account, only 1 concurrent user is available, as more than 1 VM’s need account upgrade. Feel free to look at their pricing plans over here:

Step 2: Navigate to “Selenium Desiredcapabilities Generator” tool by LambdaTest at as shown in image below.

Step 3: Select the required programming language and operating system and browser configuration as per the requirement, you can enable screenshots and video recording as well. You have a feature of enabling advance configuration as well, which lets you define tunnel, console and network logs and time zone selections.

Step 4: Copy the code and define the capabilities for remote webdriver in your Step Implementation file. Code for the same as specified below.

Specified parameters required while setting desired capabilities required for executing test remotely.

Parameter Description Example
YOUR_USERNAME Lamda Test username should be provided as an input tester1
YOUR_ACCESS_KEY Access token can be generated through lambdatest webapp qYlLn1IzVrC2U41zM4kyjv35EvpHxR2tyMB4aEBlkNMmvpnQ5A
gridURL To hit lamdatest grid URL of your account “”
build Your build name “Build_12.2.012”
name Your test name “TC_01_Sample Test Case”
platform Specify desired platform Windows 10
browserName Specify desired browser for test to execute Chrome
version Specify desired browser version “71.0”
visual Specify if video recording is required for the test TRUE

Step 5: Execute the specification and observe the terminal for test status.

Step 6: Login to LambdaTest Dashboard, select the automation tab to view your logs of completed tests. Dashboard view would let you see the analytical information related to the tests triggered on the LambdaTest.


Automation logs which are a part of the automation dashboard provides you with information related to server information, test ID, time stamp of execution in JSON format.


Metadata under automation dashboard provides information related to input, meta and browser configuration as shown in image below.

You can even download the test logs such as screenshots and video recordings, if opted from this tab.

Analytics Dashboard

Analytic view of builds ran, time consumed, build related information of test status such as pass or fail and bugs logged which can be viewed in both build view and test view.

You can even sort the data using date, user information.


Default dashboard view provides you with the overview of how many active concurrent sessions are running and minutes consumed in execution and the build statuses.

Automation Dashboard View

Automation dashboard view would help you view the timeline of tests executed and information of logs, metadata and network related information for each test explicitly.

Test Script maintenance becomes a nightmare once the test framework attains maturity or if we have to make use of the framework for upcoming builds without any problems. Test automation with Gauge framework make both, test authoring and test maintenance, an easy task.

Another highlight for performing test automation with Gauge framework is the excellent support system, you can reach out to the creators through creating a GitHub issue if you face any roadblocks and if you are in need of help with the framework.

To conclude what we have discussed so far, we have kick started our framework setup of the Gauge framework from scratch and created our first script and integrated it with LambdaTest to achieve our cross browser testing and parallel execution goals. Discussed the features and benefits of the tool, importance and the need of cross browser and parallel test execution along with execution and analysis of logs in LambdaTest platform.

There is a lot more to LambdaTest than Selenium based automated cross browser testing. You can reach out to their customer support chat from here in case of any questions. You could also schedule a free of cost, complete product demo.

Thank you for reading the article, please let me know your thoughts in the comments section.

Author Profile Author Profile Author Profile

Author’s Profile

Bharadwaj Pendyala

Bharadwaj has more than 5+ year of experience in handling Automation Testing who is also an expert in handling Manual Testing, API Automation, Performance Testing and Certified Agile Practitioner who is currently handling projects in TDD and BDD methodologies with both custom built and hybrid automation frameworks

Blogs: 4


Test Your Web Or Mobile Apps On 3000+ Browsers

Signup for free