https://github.com/jason916/mocha-report-v2
mocha report generator
https://github.com/jason916/mocha-report-v2
generator mocha reason report simple
Last synced: 29 days ago
JSON representation
mocha report generator
- Host: GitHub
- URL: https://github.com/jason916/mocha-report-v2
- Owner: Jason916
- License: mit
- Created: 2020-08-15T06:59:12.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-11-09T09:34:02.000Z (over 5 years ago)
- Last Synced: 2025-02-27T18:08:19.059Z (over 1 year ago)
- Topics: generator, mocha, reason, report, simple
- Language: JavaScript
- Homepage:
- Size: 1.79 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
mocha-report-v2 (marge)
============================
[](http://www.npmjs.com/package/mochawesome-report-generator) [](https://travis-ci.org/adamgruber/mochawesome-report-generator) [](https://codeclimate.com/github/adamgruber/mochawesome-report-generator/test_coverage) [](https://codeclimate.com/github/adamgruber/mochawesome-report-generator/maintainability)
**marge** (**m**och**a**wesome-**r**eport-**ge**nerator) is the counterpart to [mochawesome][2], a custom reporter for use with the Javascript testing framework, [mocha][1]. Marge takes the JSON output from [mochawesome][2] and generates a full fledged HTML/CSS report that helps visualize your test suites.
## Features
- Simple, clean, and modern design
- Beautiful charts
- Support for test and suite nesting
- Displays before and after hooks
- Review test code inline
- Stack trace for failed tests
- Support for adding context information to tests
- Filters to display only the tests you want
- Responsive and mobile-friendly
- Offline viewing
- Support for IE9+
- CLI for generating reports independent of [mochawesome][2]
## Usage with mochawesome
1. Add Mochawesome to your project:
`npm install --save-dev mochawesome`
2. Tell mocha to use the Mochawesome reporter:
`mocha testfile.js --reporter mochawesome`
3. If using mocha programatically:
```js
var mocha = new Mocha({
reporter: 'mochawesome'
});
```
## CLI Usage
Install mocha-report-v2 package
```bash
npm install -g mocha-report-v2
```
Run the command
```bash
marge [options] data_file [data_file2 ...]
```
## Output
**marge** generates the following inside your project directory:
```
mochawesome-report/
├── assets
│ ├── app.css
│ ├── app.js
│ ├── MaterialIcons-Regular.woff
│ ├── MaterialIcons-Regular.woff2
│ ├── roboto-light-webfont.woff
│ ├── roboto-light-webfont.woff2
│ ├── roboto-medium-webfont.woff
│ ├── roboto-medium-webfont.woff2
│ ├── roboto-regular-webfont.woff
│ └── roboto-regular-webfont.woff2
└── mochawesome.html
```
## Options
### CLI Flags
**marge** can be configured via the following command line flags:
Flag | Type | Default | Description
:--- | :--- | :------ | :----------
-f, --reportFilename | string | | Filename of saved report
-o, --reportDir | string | [cwd]/mochawesome-report | Path to save report
-t, --reportTitle | string | mochawesome | Report title
-p, --reportPageTitle | string | mochawesome-report | Browser title
-i, --inline | boolean | false | Inline report assets (scripts, styles)
--cdn | boolean | false | Load report assets via CDN (unpkg.com)
--assetsDir | string | [cwd]/mochawesome-report/assets | Path to save report assets (js/css)
--charts | boolean | true | Display Suite charts
--code | boolean | true | Display test code
--autoOpen | boolean | false | Automatically open the report
--overwrite | boolean | true | Overwrite existing report files. *See [notes](#overwrite).*
--timestamp, --ts | string | | Append timestamp in specified format to report filename. *See [notes](#timestamp).*
--showPassed | boolean | true | Set initial state of "Show Passed" filter
--showFailed | boolean | true | Set initial state of "Show Failed" filter
--showPending | boolean | true | Set initial state of "Show Pending" filter
--showSkipped | boolean | false | Set initial state of "Show Skipped" filter
--showHooks | string | failed | Set the default display mode for hooks
--saveJson | boolean | false |Should report data be saved to JSON file
--saveHtml | boolean | true | Should report be saved to HTML file
--dev | boolean | false | Enable dev mode (requires local webpack dev server)
-h, --help | | | Show CLI help
*Boolean options can be negated by adding `--no` before the option. For example: `--no-code` would set `code` to `false`.*
#### Overwrite
By default, report files are overwritten by subsequent report generation. Passing `--overwrite=false` will not replace existing files. Instead, if a duplicate filename is found, the report will be saved with a counter digit added to the filename. (ie. `mochawesome_001.html`).
**Note:** `overwrite` will always be `false` when passing multiple files or using the `timestamp` option.
#### Timestamp
The `timestamp` option can be used to append a timestamp to the report filename. It uses [dateformat][] to parse format strings so you can pass any valid string that [dateformat][] accepts with a few exceptions. In order to produce valid filenames, the following
replacements are made:
Characters | Replacement | Example | Output
:--- | :--- | :--- | :---
spaces, commas | underscore | Wed March 29, 2017 | Wed_March_29_2017
slashes | hyphen | 3/29/2017 | 3-29-2017
colons | null | 17:46:21 | 174621
Further, if you pass the flag with no format string, it will default to `isoDateTime`.
### mochawesome `reporter-options`
The above CLI flags can be used as `reporter-options` when using the mochawesome reporter.
Use them in a `mocha.opts` file:
```js
--reporter mochawesome
--reporter-options overwrite=true,reportTitle=My\ Custom\ Title,showPassed=false
```
or as an object when using mocha programmatically:
```js
const mocha = new Mocha({
reporter: 'mochawesome',
reporterOptions: {
overwrite: true,
reportTitle: 'My Custom Title',
showPassed: false
}
});
```
## Development
To develop locally, clone the repo and install dependencies. In order to test end-to-end you must also clone [mochawesome][2] into a directory at the same level as this repo.
You can start the dev server with `npm run devserver`. If you are working on the CLI, use `npm run dev:cli` to watch for changes and rebuild.
### Running Tests
#### Unit Tests
To run unit tests, simply use `npm run test`. You can also run a single unit test with `npm run test:single path/to/test.js`.
#### Functional Tests
Functional tests allow you to run real-world test cases in order to debug the output report. First, start up the dev server in one terminal window with `npm run devserver`. Then, in another window, run the tests with `npm run test:functional`. This will generate a report that you can open in the browser and debug.
If you want to run a specific folder of functional tests:
`npm run test:functional path/to/tests`
Or if you want to run a single test:
`npm run test:functional path/to/test.js`
Or mix and match:
`npm run test:functional path/to/some/tests path/to/another/test.js`
[1]: https://mochajs.org/
[2]: https://github.com/adamgruber/mochawesome
[dateformat]: https://github.com/felixge/node-dateformat
[CHANGELOG]: CHANGELOG.md