Cucumber.decorators NPM

Cucumber.Decorators

Typescript Decorators for Cucumber Tests

Cucumber Example

Feature File

Feature: Local server test
    As a developer
    I want check the web site

    Background:
        Given I open the url "http://www.google.com"

    Scenario: Google
        Then I expect that the title is "Google"

Typescript Step File

import { cucumber, given, when } from '../decorator/decorator'
import action from '../helpers/action';
import check from '../helpers/check';

@cucumber
class checkSite {
    @given(/^I open the (url|site) "([^"]*)?"$/)
    public openWebsite() {
        return action.Open;
    };

    @when(/^I expect that the title is( not)* "([^"]*)?"$/)
    public title() {
        return check.Title
    };
};

let CheckSite = new checkSite();

Development Prerequisites

Typescript
JAVA
Chromedriver

Run Example

To run the example you will need to clone the repo as the npm package was designed to be as small as possible.

git clone https://github.com/FlippieCoetser/Cucumber.Decorators
npm install
npm run build
npm run demo

Note: When node-gyp produces an error, first install windows-build-tools globally and set the config to the correct version.
npm install --global --production windows-build-tools
npm config set msvs_version 2015 --global

Explanation

The cucumber Decorator updates the class constuctor to ensure each method within the class is executed during instantiation.

export function cucumber(target: Function){
    for (var member in target.prototype) {
        target.prototype[member]();
    }
}

The given Decorator wraps the provided method and passes the expression into the required cucumber function.

export function given(expression: any) {
    return function(target: Object, propertyKey: string, descriptor: TypedPropertyDescriptor<any>){
        let assertion = descriptor.value();

        descriptor.value = () => Given(expression,assertion);
        
        return descriptor;
    }
}

Note: the when and then Decorator operates in a similar fashion as the given Decorator.