Writing Feature Files for Selenium Java with Cucumber

In the world of test automation, combining Selenium with Cucumber offers a powerful framework for writing behavior-driven development (BDD) tests. This approach bridges the gap between technical testers and business stakeholders by allowing test scenarios to be written in plain English using Gherkin syntax. One of the core elements of this process is the Feature File. Let’s explore what feature files are, how to write them, and best practices for creating effective scenarios.

🧩 What is a Feature File?

A feature file in Cucumber is a text file that contains scenarios written in Gherkin language. It describes the software’s behavior without diving into the code. These files have a .feature extension and serve as the basis for Cucumber to understand and execute tests.

Each feature file typically includes:

A Feature name and description

Multiple Scenarios or Scenario Outlines

Steps defined with keywords like Given, When, Then, And, But

✍️ Writing Your First Feature File

Let’s assume we are testing a login functionality on a website. Here's how a basic feature file might look:

gherkin

Feature: Login Functionality

  As a registered user

  I want to log into the application

  So that I can access my dashboard

  Scenario: Successful login with valid credentials

    Given the user is on the login page

    When the user enters valid username and password

    And clicks the login button

    Then the user should be redirected to the dashboard

  Scenario: Unsuccessful login with invalid credentials

    Given the user is on the login page

    When the user enters invalid username or password

    And clicks the login button

    Then an error message should be displayed

🛠 Mapping Feature Steps to Step Definitions in Java

Every line in the feature file corresponds to a step definition in Java, which interacts with the Selenium WebDriver.

Example:

java

Copy

Edit

@Given("the user is on the login page")

public void userOnLoginPage() {

    driver.get("https://example.com/login");

}

@When("the user enters valid username and password")

public void enterCredentials() {

    driver.findElement(By.id("username")).sendKeys("testuser");

    driver.findElement(By.id("password")).sendKeys("securePass123");

}

@Then("the user should be redirected to the dashboard")

public void verifyDashboard() {

    Assert.assertTrue(driver.getCurrentUrl().contains("dashboard"));

}

🧠 Best Practices for Writing Feature Files

Use Simple Language: Write steps in a language understandable by non-technical stakeholders.

One Feature per File: Each file should focus on one application functionality.

Reuse Steps: Create reusable step definitions to avoid code duplication.

Avoid UI Details: Keep Gherkin steps abstracted from UI elements.

Use Scenario Outline for Data-Driven Testing: For testing with multiple data sets.

Example:

gherkin

Scenario Outline: Login with different credentials

  Given the user is on the login page

  When the user enters "<username>" and "<password>"

  Then the result should be "<status>"

  Examples:

    | username | password    | status         |

    | user1    | pass123     | success        |

    | user2    | wrongpass   | error message  |

🧾 Conclusion

Feature files are the backbone of Cucumber's BDD approach and help bring clarity to testing processes. When paired with Selenium and Java, they allow teams to write automated UI tests in an easily understandable format. Whether you're working in Agile or just want a more collaborative testing process, learning how to write and maintain feature files effectively is an essential skill for any automation tester.

By mastering Gherkin syntax and integrating it properly with Java step definitions, you can create a powerful, maintainable test suite that aligns with your project’s goals. 

Learn Selenium with Java Training

Read More: Selenium Java with Cucumber: Behavior-Driven Development (BDD) Basics
Read More: Automating Mobile Web Testing Using Selenium Java and Appium

Read More: Using Sikuli with Selenium Java for Image-Based Automation

Visit Our IHUB Talent Institute Hyderabad
Get Direction