Lighweight version of CucumberJS library. Supports real-time test debugging.
{
timeoutMS?: number; // (default 10000ms)
}
Examples:
defineStep("It should open a browser.", { timeoutMS: 5000 }, async function () {
// step body
});
defineStep("It should open a browser.", async function () {
// step body
});
defineStep("It should open a browser {int} times.", async function (count: number) {
/**
* For 'It should open a browser 5 times.'
* count will be '5'
*/
});
defineStep("It should open a display message {string}.", async function (message: string) {
/**
* For 'It should open a display message "An error has occured!".'
* message will be 'An error has occured!'
*/
this.variables["message"] = message; // Transfer variables between steps
});
defineStep(/It can also use regexes\. Look what I found\: ([a-z]+)\./, async function (message: string) {
/**
* For 'It can also use regexes. Look what I found: test.'
* message will be 'test'
*/
this.variables["message"] = message; // Transfer variables between steps
});
- int - {int}
- decimal - {decimal}
- string - {string}
IStepExpressionDef:
{
key: string; // Unique
pattern: RegExp;
parser: (value: any) => any; // Used to convert to target type
}
Example:
// Definition
defineExpression({
key: "bool",
pattern: /true|false/,
parser: v => v === "true" ? true : v === "false" ? false : new Error("Value is in incorrect format.");
});
// Usage
defineStep("Checkbox state is set to {bool}.", async function (state: boolean) {
/**
* For 'Checkbox state is set to true.'
* state will be 'true'
*/
});
Command line usage:
pickle [(-r, --require <glob_expr>), (-j, --junit <xml_path>), (-o, --output <log_path>), -d] <feature_path>
Parameters:
-
-r <glob_expr>
--require <glob_expr>
- Path to directory with all step definitions. Should end with *.js or (preferably) *.ts -
-j <xml_path>
--junit <xml_path>
- Path to save the JUnit xml with test execution summary -
-o <log_path>
--output <log_path>
- Path to save the test execution log -
-d
--debug
- Execute test in debug mode. For details please take a look a theDebugger
section. -
--trace-size <number>
- Increase the error stack trace size. Default is 20.
Examples:
pickle -r ./Flows/**/*.js ./test.feature
pickle -r ./Flows/**/*.js -j ./junit.xml -o ./Output.log ./test.feature
pickle --require ./Flows/**/*.js --junit ./junit.xml --output ./Output.log ./test.feature
Pickle test runner is delivered with web based debugging tool which allows running features in step by step mode. Features:
- Run feature steps and pause at any time
- Step Breakpoints
- Ability to edit test variables during execution
- On-demand reload of source files. Useful when step definitions are adjusted and you want to continue the test where it failed.
The source for Pickle Debugger is available in separate repository. The compiled bundle.js and index.html file is built and included in Pickle Test Runner.