cucumber-electron

cucumber-electron

Runs Cucumber.js in an Electron renderer process. Scenarios have direct access to both a browser DOM and node.js libraries, so they are fast and easy to debug interactively.

Install

Both Electron and Cucumber.js need to be installed, they are peer dependencies. This gives you the option to choose the version you want to use:

npm install --save-dev electron @cucumber/cucumber @cucumber/electron

Usage

Cucumber-electron is a wrapper around Cucumber.js, supporting the same features and command-line options. You should be able to use it on your project without any changes.

Run cucumber-electron like it was Cucumber.js, for example:

npx cucumber-electron ./features/your.feature:123

Interactive Debugging

The --interactive (or -i) command line switch shows a browser window with chrome dev tools and keeps the window open after all features have finished running.

The interactive debugger will halt execution on any debugger statements, or breakpoints you have set in chrome dev tools.

Changelog

[3.0.0-rc.0] - 2020-10-16

• Cucumber-electron now depends on @cucumber/cucumber-7.0.0-rc.0 and above (not backward-compatible with previous versions) as an explicit peer dependency. You need to install it alongside cucumber-electron in your project.
• Electron is also now an explicit peer dependency. Versions from 8.2.0 to 10 are supported. This gives you more freedom if you also use Electron in your app.
• We now officially support Node.js v14 (in addition to 8, 10 and 12).