@modix/mx-cucumber-cli
v2.1.14
Published
cli tool for running tests with the framework cucumber-js
Downloads
5
Readme
Requirements for using this tool For including this libary into your project, the following things needs to be in place:
- You need to have NodeJS up and running on your machine
- Chrome and Firefox needs to be installed
Installation
The Tool can be installed Globally via the command
npm i -g @modix/mx-cucumber-cli
or can be included in any project, with npm i -D @modix/mx-cucumber-cli
. Since the testcase are comming from an external repository, you need to take care, that the mx-cucumber-cli is allways up to date, before running any tests.
Usage
If you have installed mx-cucumber-cli globally, you can simply open the help, to get an overview about the possible commands, via the following command:
mx-cucmber-cli --help
Example usage with the minimum set of arguments:
mx-cucmber-cli --config=./config.json --features=./features
Here is a list of all arguments and their usage:
Argument | Description -------- | ----------- --config | path to your config.json --steps | path to your own step-definition folder --feature | path tom your own feature file folder --tags | forward tag parameter to cucumberJS --url | an URL given here will overwrite all URLs stated in the config --validate| checks your config before performing tests. You can opt out after validation
Config JSON
For more flexibility in test cases the confi JSON provides a mapping and different options to add browsers, URLs, languages and routing.
{
"language": [
"en"
],
"browser": [
"chrome"
],
"baseUrl": [
"https://www.npmjs.com/"
],
"Pages": {
"All": {
"mapping": {
"Cookie hint": {
"cssSelector": ".cookie-hint"
}
}
}
"Homepage": {
"routes": {
"en": {
"route": "/en/home",
"title": "Awesome Site Title"
},
"de": {
"route": "/de/startseite",
}
},
mapping: {
"headline":{
"cssSelector": "h1"
}
}
}
}
}
at this point there is only 'chrome' and 'firefox' as browser options available
For generating the config.json, the following Tool could be helpfull: http://cucumber-js.x.modix.de/cucumber-js