Improve this doc

Allure Reporter

The Allure Reporter creates Allure test reports which is an HTML generated website with all necessary information to debug your test results and take a look on error screenshots. To use it just install it from NPM:

1
$ npm install wdio-allure-reporter --save-dev

Then add allure to the reporters array in your wdio.conf.js and define the output directory of the allure reports:

1
2
3
4
5
6
7
8
9
10
11
// wdio.conf.js
exports.config = {
// ...
reporters: ['dot', 'allure'],
reporterOptions: {
allure: {
outputDir: 'allure-results'
}
},
// ...
}

outputDir defaults to ./allure-results. After a test run is complete, you will find that this directory has been populated with an .xml file for each spec, plus a number of .txt and .png files and other attachments.

Displaying the report

The results can be consumed by any of the reporting tools offered by Allure. For example:

Jenkins

Install the Allure Jenkins plugin, and configure it to read from the correct directory:

Configure Allure Reporter with Jenkins

Jenkins will then offer a link to the results from the build status page:

Allure Link

If you open a report at the first time you probably will notice that Jenkins won’t serve the assets due to security restrictions. If that is the case go to Jenkins script console (http://<your_jenkins_instance>/script) and put in these security settings:

1
2
System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval'; style-src 'self' 'unsafe-inline';")
System.setProperty("jenkins.model.DirectoryBrowserSupport.CSP", "default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval'; style-src 'self' 'unsafe-inline';")

Apply and restart the Jenkins server. All assets should now be served correctly.

Command-line

Install the Allure command-line tool, and process the results directory:

1
$ allure generate [allure_output_dir] && allure open

This will generate a report (by default in ./allure-report), and open it in your browser:

Allure Website