README.md

allure-cucumberjs

Allure integration for cucumber-js compatible with @cucumber/cucumber@^8.x.x and Allure 2+.

• Learn more about Allure Report at https://allurereport.org
• 📚 Documentation – discover official documentation for Allure Report
• ❓ Questions and Support – get help from the team and community
• 📢 Official annoucements – be in touch with the latest updates
• 💬 General Discussion – engage in casual conversations, share insights and ideas with the community

---

The documentation and examples

The docs for Allure Cucumber.js are available at https://allurereport.org/docs/cucumberjs/.

Also, check out the examples at github.com/allure-examples.

Installation

Install allure-cucumberjs using a package manager of your choice. For example:

npm install -D allure-cucumberjs

If you're a Yarn PnP user, please read this.

Usage

Enable the allure-cucumberjs/reporter formatter in the Cucumber.js configuration file:

{
  "default": {
    "format": [
      "allure-cucumberjs/reporter"
    ]
  }
}

Alternatively, you may specify the formatter via the CLI:

npx cucumber-js --format allure-cucumberjs/reporter

When the test run completes, the result files will be generated in the ./allure-results directory.

You may select another location, or further customize the formatter's behavior with the configuration options.

View the report

You need Allure Report to be installed on your machine to generate and open the report from the result files. See the installation instructions on how to get it.

Generate Allure Report after the tests are executed:

allure generate ./allure-results -o ./allure-report

Open the generated report:

allure open ./allure-report

Allure API

Enhance the report by utilizing the Allure API:

import { When } from "@cucumber/cucumber";
import * as allure from "allure-js-commons";

Given("an active user", async function () {
  await allure.description("The test checks if an active user with a valid password can sign in to the app.");
  await allure.epic("Signing in");
  await allure.tags("signin", "ui", "positive");
  await allure.issue("https://github.com/allure-framework/allure-js/issues/1", "ISSUE-1");
  await allure.owner("eroshenkoam");
  await allure.parameter("browser", "chrome");

  this.user = await createAnActiveUserInDb();
});

When("they sign in with a valid password", async function () {
  await allure.step("Navigate to the sign in page", async () => {
    // ...
  });

  await allure.step("Fill the sign-in form", async (stepContext) => {
    await stepContext.parameter("login", this.user.login);
    await stepContext.parameter("password", this.user.password, "masked");

    // ...
  });

  await allure.step("Submit the form", async () => {
    // ...
    // const responseData = ...

    await allure.attachment("response", JSON.stringify(responseData), { contentType: "application/json" });
  });
});

// ...

More details about the API are available at https://allurereport.org/docs/cucumberjs-reference/.