TestCafe Reporter Inrupt

This package is a modification of the original TestCafe Slack reporter.

This TestCafe reporter is configurable to:

• Sends test results to the Console and/or Slack.
• Send the report in pieces or as a whole.
• Optionally includes errors.

Installation

To install this reporter via npm to your TestCafe project, execute:

npm install --save-dev testcafe-reporter-inrupt

Setup

In order to use this TestCafe reporter plugin, it is necessary to add it as your reporter to your TestCafe .testcaferc.json configuration file:

{
  "reporter": [
    {
      "name": "inrupt"
    }
  ]
}

Configuration

In order to use this TestCafe reporter plugin it is necessary to define some .env variables in your test project (i.e., the folder from where your call TestCafe).

• cd into your test project.
• Create or edit the .env file by adding the following required variables:

Variable	Required?	Default	Description
TESTCAFE_REPORT_TOCONSOLE	No	true	Should the report be sent to the Console?
TESTCAFE_REPORT_CONSOLE_INCLUDEHEADER	No	false	Include Header information in Console report?
TESTCAFE_REPORT_CONSOLE_MERGE	No	false	Should the test results be merged into a single Console report, or output individually?
TESTCAFE_REPORT_CONSOLE_SHOWERRORS	No	true	Should detailed error messages be displayed in the Console report?
TESTCAFE_REPORT_TOSLACK	No	false	Should the report be sent to Slack?
TESTCAFE_REPORT_SLACK_INCLUDEHEADER	No	false	Include Header information in Slack report?
TESTCAFE_REPORT_SLACK_MERGE	No	true	Should the test results be merged into a single Slack report, or output individually?
TESTCAFE_REPORT_SLACK_SHOWERRORS	No	false	Should detailed error messages be displayed in the Slack report?
TESTCAFE_SLACK_WEBHOOK	Yes if reporting to Slack, No otherwise	-	Slack Webhook URL
TESTCAFE_SLACK_CHANNEL	No	#testcafe	Name of the Slack channel to which report will be sent
TESTCAFE_SLACK_USERNAME	No	testcafebot	Name of the Slack user under which the report will be posted

An example .env file is shown below:

TESTCAFE_REPORT_TOCONSOLE = true
TESTCAFE_REPORT_CONSOLE_INCLUDEHEADER = true
TESTCAFE_REPORT_CONSOLE_MERGE = false
TESTCAFE_REPORT_CONSOLE_SHOWERRORS = true

TESTCAFE_REPORT_TOSLACK = true
TESTCAFE_REPORT_SLACK_INCLUDEHEADER = false
TESTCAFE_REPORT_SLACK_MERGE = true
TESTCAFE_REPORT_CONSOLE_SHOWERRORS = false
TESTCAFE_SLACK_WEBHOOK=https://hooks.slack.com/services/*****
TESTCAFE_SLACK_CHANNEL='#testcafe'
TESTCAFE_SLACK_USERNAME=testcafebot

When you use TestCafe API, you can pass the reporter name to the reporter() method:

const inrupt = require('@kevin-inrupt/testcafe-reporter-inrupt')

testCafe
    .createRunner()
    .src('path/to/test/file.js')
    .browsers('chrome')
    .reporter(inrupt) // <-
    .run();

Further Documentation

TestCafe Reporter Plugins