FAQ
Frequently asked questions and troubleshooting common issues in Multiple Cucumber HTML Reporter.
Here are common issues and solutions while setting up or using the reporter.
Report Issues
Why are my reports being overwritten?
If only one report is shown, the JSON file names generated by Cucumber might not be unique enough.
Tip
Always include a unique identifier like the feature name, browser, and a timestamp in your JSON filename:
`${featureName}.${browserName}.${new Date().getTime()}.json`Why does metadata show as "not known" or icons are missing?
This usually happens because:
- Metadata wasn't correctly added to the Cucumber JSON results.
- The
metadata.browser.nameormetadata.platform.namevalues were not recognized.
Verify that your values match the supported browser and platform names in our Metadata Guide.
Screenshot & Attachment Issues
How can I attach screenshots?
You can attach screenshots during test execution as Base64 strings using the Cucumber world.attach method within your hooks or steps.
Does it support pretty JSON?
Yes, just pass the JSON string and set the MIME type to application/json when calling attach.
Can I give my logs and attachments custom names?
Yes. By default attachments are labelled Log 1, Screenshot 1, Attachment 1, etc. Attach with a fileName (or add a name/fileName to the embedding in the JSON) and the reporter uses it as the label. See Custom Attachment Names for details.
Dashboard & Charts
What do the numbers on the pie/donut charts mean?
The dashboard donut charts (Features, Scenarios, Steps) show the breakdown by status. The legend shows the count for each status (e.g. Passed: 9), the centre of the donut shows the total, and hovering a slice shows the count in the tooltip.
If you set the displayChartPercentages: true option, each slice is additionally labelled with its percentage (e.g. 35%) and the tooltip shows both the count and the percentage together (e.g. 9 (35.0%)). This is off by default — see the Options page.
Other Questions
Can I run this in Parallel?
Yes, since the report merges all JSON files found in the jsonDir, it's perfect for parallel execution support.
Is it compatible with Protractor?
If you are using Protractor, we recommend using the dedicated protractor-multiple-cucumber-html-reporter-plugin for a more seamless experience.
Last updated on