Running Cypress Cucumber Preprocessor with HyperExecute

Steps to execute your Cypress tests on HyperExecute

Prerequisites

• Node.js and npm
• Basic knowledge of Cypress and Cucumber
• Cypress version >= 10
• Create your free TestMu AI account
• Your TestMu AI Username and Access Key

2M+ Devs and QAs rely on TestMu AI

Deliver immersive digital experiences with Next-Generation Mobile Apps and Cross Browser Testing Cloud

Sign up with googleSign up with Email

Setting up the Project

Below are the steps to set your cypress project for execution in the HyperExecute platform

• Step 1: Create a folder and generate package.json.
• Create a project, naming it cypress-cucumber-preprocessor.
• Use the npm init command to create a package.json file
• Step 2: Write your testing scenarios in Gherkin syntax
• Create a folder named cypress > e2e
• Define your feature files
• Write the corresponding step definition

• Step 3: Download the HyperExeute CLI
• HyperExecute CLI is a command line interface that lets you trigger your tests on the HyperExecute platform.
• Download the CLI as per your respective operating system in the root folder of your project.

Operating System	HyperExecute CLI Download URL
Linux	https://downloads.lambdatest.com/hyperexecute/linux/hyperexecute
Windows	https://downloads.lambdatest.com/hyperexecute/windows/hyperexecute.exe
macOS	https://downloads.lambdatest.com/hyperexecute/darwin/hyperexecute

• Step 4: Create your HyperExecute YAML file.
  The YAML file allows you to define the configurations required for executing your tests on HyperExecute.
• runson: In this flag, define the operating system where you want to spin up your test
• pre: In this flag, we pass all the commands required to run your test. In this case, @badeball/cypress-cucumber-preprocessor

A sample YAML file is shown below for your reference:

---
version: 0.1

runson: win
cypress: true

autosplit: true
concurrency: 1

cacheKey: '{{ checksum "package.json" }}'
cacheDirectories:
  - node_modules

pre:
  - npm install
  - npm install cypress --save-dev
  - npm install @badeball/cypress-cucumber-preprocessor

testDiscovery:
  mode: static
  type: raw
  command: ls cypress/e2e/*.js

testRunnerCommand: npx cypress run --spec cypress/e2e/duckduckgo.feature --browser=chrome-95.0 --headed --config video=false

cypressOps:
  Build: "HyperExecute-Cypress-Badeball-Build"
  Tags: ["HyperExecute","Cypress", "Badeball"]
  BuildTags: ["Hyperexecute-Cypress"]
  Network: true

jobLabel: [cypress, hyperexecute, badeball-plugin]

• Step 5: Execute your Test in the HyperExecute
  NOTE: In the case of macOS, if you get a permission denied warning while executing CLI, simply run chmod u+x ./hyperexecute to allow permission. If you get a security popup, allow it from your System Preferences → Security & Privacy → General tab.

Run the below command in your terminal at the root folder of the project:

./hyperexecute --user YOUR_USERNAME --key YOUR_ACCESS_KEY --config RELATIVE_PATH_OF_YOUR_YAML_FILE