Jasmine-line-per-spec-reporter NPM

jasmine-line-per-spec-reporter 0.3.0 (2016-04-20)

Always report one line per spec, regardless of spec status.

Provided as a reporter class for the jasmine test framework.

Example

The output format is:

status-right-padded - spec-number-left-padded/total-spec-count - full suite/spec description
                                                                 indented expect messages
                                                                 are output on FAILURE

Such that output would look like:

Passed   -   1/4 - Suite one Sub-suite AAA Spec one
FAILED   -   2/4 - Suite one Sub-suite BBB Spec two
                   Expected 1 to be 0.

Pending  -   3/4 - Suite one Sub-suite BBB Spec three
Disabled -   4/4 - Suite one Sub-suite CCC Spec four

Given these suites/specs:

describe('Suite one', () => {
    describe('Sub-suite AAA', () => {
        it('Spec one', () => {
            expect(0).toBe(0);
        });
    });

    describe('Sub-suite BBB', () => {
        it('Spec two', () => {
            expect(1).toBe(0);
        });

        xit('Spec three', () => {
            expect(0).toBe(0);
        });
    });

    xdescribe('Sub-suite CCC', () => {
        it('Spec four', () => {
            expect(0).toBe(0);
        });
    });
});

Installation

The easiest way is to keep jasmine-line-per-spec-reporter as a devDependency in your package.json. Just run

npm install jasmine-line-per-spec-reporter --save-dev

to let npm automatically add it there.

Configuration

`protractor`

In your protractor.conf.js file:

At the top, or with the other require lines, add:

const JasmineLinePerSpecReporter = require('jasmine-line-per-spec-reporter');

In the config.onPrepare function, add:

    if (browser.params.linePerSpecReporter === true) {
        jasmine.getEnv().addReporter(new JasmineLinePerSpecReporter(jasmine));
    }

You can also hide disabled specs. So, if you're using any fdescribe/fit, or disabling remaining lines on failure, you won't see superfluous Disabled lines. In the config.onPrepare function, add:

```js
    if (browser.params.linePerSpecReporter === true) {
        const conifg = {
            hideDisabled: true
        };
        jasmine.getEnv().addReporter(new JasmineLinePerSpecReporter(jasmine, config));
    }
```

This will produce output like the following:

```bash
Passed   -   1/4 - Suite one Sub-suite AAA Spec one
FAILED   -   2/4 - Suite one Sub-suite BBB Spec two
                   Expected 1 to be 0.

Pending  -   3/4 - Suite one Sub-suite BBB Spec three

1 disabled spec was hidden
```

You can also see stack trace lines that only match the path to your spec files, without all the extra stack trace junk you get from the default reporter. E.g., If you project root folder is my-project-folder and all your tests are in my-project-folder/test/spec, then in the config.onPrepare function, add:

```js
    if (browser.params.linePerSpecReporter === true) {
        const conifg = {
            failureExpectationMessageSuffixLine: '',
            failureSuffixLine: null,
            showStackTrace: true,
            showStackTraceRegExMatch: /^.*[\\\/](my-project-folder[\\\/]test[\\\/]spec[\\\/].*)\)$/g,
            showStackTraceRegExReplace: '  at $1',
            showStackTraceRegExShowMax: 1
        };
        jasmine.getEnv().addReporter(new JasmineLinePerSpecReporter(jasmine, config));
    }
```

This will produce output for each failure showing only the first stack trace line that matches your criteria, like the following:

```bash
Passed   -   1/4 - Suite one Sub-suite AAA Spec one
FAILED   -   2/4 - Suite one Sub-suite BBB Spec two
                   Expected 1 to be 0.
                   Stack trace (replaced lines):
                     at my-project-folder/test/spec/myTest.js:10:8

Pending  -   3/4 - Suite one Sub-suite BBB Spec three
Disabled -   4/4 - Suite one Sub-suite CCC Spec four
```

`grunt` + `protractor`

If you are using grunt, this configuration will allow you to specify the protractor flag from the grunt command line.

You must modify the protractor configuration in your Gruntfile.js as:

    protractor: {
        options: {
            args: {
                params: {
                    // Map the `grunt` command line argument:
                    //     --linePerSpecReporter=true
                    // to the `protractor` boolean property:
                    //     browser.params.linePerSpecReporter
                    linePerSpecReporter: grunt.option('linePerSpecReporter')
                }
            }
        }
    }

`grunt` + regular `jasmine`

TODO

Usage

`protractor`

Run your usual protractor command with the extra flag:

--params.linePerSpecReporter=true

e.g.:

protractor --params.linePerSpecReporter=true

`grunt`

Run your usual grunt command with the extra flag:

--linePerSpecReporter=true

e.g.:

grunt test --linePerSpecReporter=true

TODO

Needs documentation -- Until fully documented, see defaultConfig in dist/jasmine-line-per-spec-reporter.js for all of the properties that can be set using optionalConfig as:
```
```js
        jasmine.getEnv().addReporter(new JasmineLinePerSpecReporter(jasmine, optionalConfig));
```
```

Feature -- Optional time prefixes:

- Delta -- time between each spec as `SS.mmm`, e.g.:

    ```bash
    00.000 Passed   -   1/4 - Suite one Sub-suite AAA Spec one
    00.250 FAILED   -   2/4 - Suite one Sub-suite BBB Spec two
                              Expected 1 to be 0.

    00.133 Pending  -   3/4 - Suite one Sub-suite BBB Spec three
    00.088 Disabled -   4/4 - Suite one Sub-suite CCC Spec four
    ```

- Relative -- time since first spec `MM:SS.mmm`, e.g.:

    ```bash
    00:00.000 Passed   -   1/4 - Suite one Sub-suite AAA Spec one
    00:00.133 FAILED   -   2/4 - Suite one Sub-suite BBB Spec two
                                 Expected 1 to be 0.

    00:00.250 Pending  -   3/4 - Suite one Sub-suite BBB Spec three
    00:00.250 Disabled -   4/4 - Suite one Sub-suite CCC Spec four
    ```

- Current -- current time as `YYYY-MM-DD HH:MM:SS.mmm`, e.g.:

    ```bash
    2016-04-19 16:00:00.000 Passed   -   1/4 - Suite one Sub-suite AAA Spec one
    2016-04-19 16:00:00.133 FAILED   -   2/4 - Suite one Sub-suite BBB Spec two
                                               Expected 1 to be 0.

    2016-04-19 16:00:00.250 Pending  -   3/4 - Suite one Sub-suite BBB Spec three
    2016-04-19 16:00:00.250 Disabled -   4/4 - Suite one Sub-suite CCC Spec four
    ```