@moroo/wdio-slack-reporter
Advanced tools
Reporter from WebdriverIO using Incoming webhook and Web API to send results to Slack.
Reporter from WebdriverIO using Incoming webhook and Web API to send results to Slack.
This package is Compatible with WebdriverIO version 6.x and above.
This project is Compatible with WebdriverIO version 6.x and above.
If you are using 4.x or lower, use to wdio-slack-reporter.
The easiest way is to keep @moroo/wdio-slack-reporter as a devDependency in your package.json.
{
"devDependencies": {
"@moroo/wdio-slack-reporter": "8.1.0"
}
}
You can simple do it by:
npm install @moroo/wdio-slack-reporter --save-dev
yarn add -D @moroo/wdio-slack-reporter
Instructions on how to install WebdriverIO can be found here.
At the top of the wdio.conf.js-file, add:
// wdio.conf.js
import SlackReporter from '@moroo/wdio-slack-reporter';
In order to use the reporter you need to add slack to your reporters array in wdio.conf.js
// wdio.conf.js
export.config = {
reporters: [
[
SlackReporter,
{
slackOptions: {
type: 'web-api',
channel: process.env.SLACK_CHANNEL || 'Cxxxxxxxxxx',
slackBotToken: process.env.SLACK_BOT_TOKEN || 'xoxb-xxxxxxxxxx-xxxxxx...',
},
}
],
],
};
The following configuration options are supported.
For notifications to be sent, You must set webhook or web-api.
If both web-api and webhook are set, web-api is used.
Required)Incoming Webhook of the slack channel to which notifications should be sent. If the URL is not configured, notifications will not be sent.
webhookstringOptional)The value of username will appear in the slack notification as the user who sent it.
webhookstring"WebdriverIO Reporter"Optional)The url of the Icon to be displayed in the slack
webhookstring"https://webdriver.io/img/webdriverio.png"Required)Web API of the slack channel to which notifications should be sent. A bot user token is required. Bot access tokens always begin with xoxb.
The bot token requires the OAuth scope of chat:write, files:write.
See below for more details.
web-apistringRequired)Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.
"How to find channel ID" - stackoverflow -
web-apistringOptional)Set this option to true to attach a screenshot to the failed case.
web-apibooleantrueOptional)This option only works when the notifyTestFinishMessage option is true.
Set this option to true if you want to add thread with details of results to notification of test results posted to Slack.
web-apibooleantrueOptional)This option only works when the notifyDetailResultThread option is true.
Add the filter you want to this option to the array and the detailed results will be filtered out in Slack and sent to the thread.
(If there are no filters (array is empty or undefined), all filters are applied.)
Filter list: passed, failed, pending, skipped
web-apiarray (passed | failed | pending | skipped)['passed', 'failed', 'pending', 'skipped']Optional)This option customizes the payload that is uploaded of the screenshot for the failure of the test.
web-apifunctionOptional)This option customizes the payload that is notified of the detailed results of the test.
web-apifunctionOptional)Set this option to the test title.
webhook, web-apistringOptional)Provide a link to the test results. It is a clickable link in the notification.
webhook, web-apistringOptional)Set this option to true to send notifications test start.
webhook, web-apibooleantrueOptional)Set this option to true to attach failed cases in the test results reported to Slack.
webhook, web-apibooleantrueOptional)Set this option to true to send notifications test finished.
webhook, web-apibooleantrueOptional) - Only CucumberSet this option to true to change the state count from test (steps) based to scenario-based. (Only Cucumber)
webhook, web-apibooleanfalseOptional)This option changes the emoji set by default.
webhook, web-apiobject:white_check_mark::x::double_vertical_bar::grey_question::rocket::checkered_flag::stopwatch:Optional)This option customizes the payload that is notified at the start of the test.
webhook, web-apifunctionOptional)This option customizes the payload that is notified at the failure of the test.
webhook, web-apifunctionOptional)This option customizes the payload that is notified of the results of the test.
webhook, web-apifunctionIf you are using webhook, can not thread and upload.
Therefore, functions related to upload and thread are not available.
// wdio.conf.js
import SlackReporter from "@moroo/wdio-slack-reporter";
export.config = {
reporters: [
[
SlackReporter, {
// Set the Slack Options used webhook.
slackOptions: {
type: 'webhook',
webhook: process.env.SLACK_WEBHOOK_URL || "https://hooks.slack.com/........",
slackName: "WebdriverIO Reporter",
slackIconUrl: "https://webdriver.io/img/webdriverio.png",
},
// Set the Title of Test.
title: 'Slack Reporter Test',
// Set the Test Results URL.
resultsUrl: process.env.JENKINS_URL,
// Set the notification of Test Finished
notifyTestFinishMessage: true,
// Set the scenario-based state count (Only Cucumber)
useScenarioBasedStateCounts: true,
// Customize Slack Emoji Symbols.
emojiSymbols: {
passed: ':white_check_mark:',
failed: ':x:',
skipped: ':double_vertical_bar:',
pending: ':grey_question:',
start: ':rocket:',
finished: ':checkered_flag:',
watch: ':stopwatch:'
},
// Override the createStartPayload function.
createStartPayload: function (runnerStats: RunnerStats): IncomingWebhookSendArguments {
const payload: IncomingWebhookSendArguments = {
// do something...
}
return payload;
},
// Override the createFailedTestPayload function.
createFailedTestPayload: function (testStats: TestStats): IncomingWebhookSendArguments {
const payload: IncomingWebhookSendArguments = {
// do something...
}
return payload;
},
// Override the createResultPayload function.
createResultPayload: function (runnerStats: RunnerStats, stateCounts: StateCount): IncomingWebhookSendArguments {
const payload: IncomingWebhookSendArguments = {
// do something...
}
return payload;
}
}
],
],
};
To use the api, you need a scopes like the one below.
chat:write, files:write. See below for more details.
// wdio.conf.js
import SlackReporter from "@moroo/wdio-slack-reporter";
export.config = {
reporters: [
[
SlackReporter, {
// Set the Slack Options used web-api.
slackOptions: {
type: 'web-api',
slackBotToken: process.env.SLACK_BOT_TOKEN || "xoxb-xxxxxxxxxx-xxxxxx...",,
channel: process.env.SLACK_CHANNEL || "Cxxxxxxxxxx",
// Set this option to true to attach a screenshot to the failed case.
uploadScreenshotOfFailedCase: true,
// Set this option to true if you want to add thread with details of results to notification of test results posted to Slack.
notifyDetailResultThread: true,
// Set the Filter for detail results. (array is empty or undefined, all filters are applied.)
filterForDetailResults: [
'passed',
'failed',
'pending',
'skipped'
],
// Override the createScreenshotPayload function.
createScreenshotPayload: function (testStats: TestStats, screenshotBuffer: Buffer): FilesUploadArguments {
const payload: FilesUploadArguments = {
// do something...
}
return payload;
},
// Override the createResultDetailPayload function.
createResultDetailPayload: function (runnerStats: RunnerStats, stateCounts: StateCount): ChatPostMessageArguments {
const payload: ChatPostMessageArguments = {
// do something...
}
return payload;
}
},
// Set the Title of Test.
title: 'Slack Reporter Test',
// Set the Test Results URL.
resultsUrl: process.env.JENKINS_URL,
// Set the notification of Test Finished
notifyTestFinishMessage: true,
// Set the scenario-based state count (Only Cucumber)
useScenarioBasedStateCounts: true,
// Customize Slack Emoji Symbols.
emojiSymbols: {
passed: ':white_check_mark:',
failed: ':x:',
skipped: ':double_vertical_bar:',
pending: ':grey_question:',
start: ':rocket:',
finished: ':checkered_flag:',
watch: ':stopwatch:'
},
// Override the createStartPayload function.
createStartPayload: function (runnerStats: RunnerStats): IncomingWebhookSendArguments {
const payload: IncomingWebhookSendArguments = {
// do something...
}
return payload;
},
// Override the createFailedTestPayload function.
createFailedTestPayload: function (testStats: TestStats): IncomingWebhookSendArguments {
const payload: IncomingWebhookSendArguments = {
// do something...
}
return payload;
},
// Override the createResultPayload function.
createResultPayload: function (runnerStats: RunnerStats, stateCounts: StateCount): IncomingWebhookSendArguments {
const payload: IncomingWebhookSendArguments = {
// do something...
}
return payload;
}
}
],
],
};
type:
() => string | undefined
Get the results url.
// getResultsUrl.spec.ts
import SlackReporter from '@moroo/wdio-slack-reporter';
describe('Get the resultsUrl value', function () {
before(function () {
const resultsUrl = SlackReporter.getResultsUrl();
if (resultsUrl) {
// do something...
}
});
it('Do something', function () {
// do something...
});
});
type:
(url: string) => void
Set the results url.
(This is useful if the url with test results changes every time.)
// setResultsUrl.spec.ts
import SlackReporter from '@moroo/wdio-slack-reporter';
import { RESULTS_URL } from '../constants';
describe('Set the resultsUrl value', function () {
before(function () {
const resultsUrl = RESULTS_URL + new Date().toISOString();
SlackReporter.setResultsUrl(resultsUrl);
});
it('Do something', function () {
// do something...
});
});
type:
(data: string | Buffer) => void
Add a screenshot as a thread to the failed test notification.
(If you are using a webhook this will print a warning and do nothing.)
// terminal console
WARN @moroo/slack-wdio-reporter: Not using web-api or disabled notifyFailedCase or uploadScreenshotOfFailedCase options.
// wdio.conf.js
export.config = {
afterTest: async function (test, context, result) {
if (error) {
const result = await browser.takeScreenshot();
SlackReporter.uploadFailedTestScreenshot(result);
}
}
}
type:
(payload: ChatPostMessageArguments) => Promise<WebAPICallResult>
Post a message to Slack.
(If you are using a webhook this will throw an error.)
// terminal console
ERROR @moroo/slack-wdio-reporter: Not using web-api.
// post.spec.ts
import SlackReporter, {
ChatPostMessageArguments,
WebAPICallResult,
} from '@moroo/wdio-slack-reporter';
describe('Post Function Test', function () {
it('Post a message', async function () {
const payload: ChatPostMessageArguments = {
// do something...
};
const result: WebAPICallResult = await SlackReporter.post(payload);
});
});
type:
(payload: FilesUploadArguments) => Promise<WebAPICallResult>
Upload a file to Slack.
(If you are using a webhook this will throw an error.)
// terminal console
ERROR @moroo/slack-wdio-reporter: Not using web-api.
// upload.spec.ts
import SlackReporter, {
FilesUploadArguments,
WebAPICallResult,
} from '@moroo/wdio-slack-reporter';
describe('Upload Function Test', function () {
it('Upload a files', async function () {
const payload: FilesUploadArguments = {
// do something...
};
const result: WebAPICallResult = await SlackReporter.upload(payload);
});
});
type:
(payload: IncomingWebhookSendArguments) => Promise<IncomingWebhookResult>
Send a message to Slack.
(If you are using a web-api this will throw an error.)
// terminal console
ERROR @moroo/slack-wdio-reporter: Not using webhook.
// send.spec.ts
import SlackReporter, {
IncomingWebhookSendArguments,
IncomingWebhookResult,
} from '@moroo/wdio-slack-reporter';
describe('Sand Function Test', function () {
it('Send a message', async function () {
const payload: IncomingWebhookSendArguments = {
// do something...
};
const result: IncomingWebhookResult = await SlackReporter.send(payload);
});
});
If you want to add a screenshot as a thread to the failed test notification, added the uploadFailedTestScreenshot function after taking the screenshot.
// wdio.conf.js
export.config = {
afterTest: async function (test, context, result) {
if (error) {
const result = await browser.takeScreenshot();
SlackReporter.uploadFailedTestScreenshot(result);
}
}
}
If the following error occurs, set reporterSyncInterval, reporterSyncTimeout in wdio.conf.js.
ERROR @wdio/runner: Error: Some reporters are still unsynced: SlackReporter
//wdio.conf.js
export.config = {
//
// Determines in which interval the reporter should check if they are synchronized if they report their logs asynchronously (e.g. if logs are streamed to a 3rd party vendor).
reporterSyncInterval: 500,
// Determines the maximum time reporters have to finish uploading all their logs until an error is being thrown by the testrunner.
reporterSyncTimeout: 20000,
}
Adding the uploadFailedTestScreenshot function here doesn't work either.
This is because the function works after every test, so the current test is unknown.
// wdio.conf.js
export.config = {
jasmineOpts: {
// Jasmine default timeout
defaultTimeoutInterval: 60000,
//
// The Jasmine framework allows interception of each assertion in order to log the state of the application
// or website depending on the result. For example, it is pretty handy to take a screenshot every time
// an assertion fails.
expectationResultHandler: function (passed, assertion) {
if (passed) {
return;
}
/*
Adding the uploadFailedTestScreenshot function here doesn't work either.
This is because the function works after every test, so the current test is unknown.
[x] const result = await browser.takeScreenshot();
[x] SlackReporter.uploadFailedTestScreenshot(result);
*/
},
},
// Add it here.
afterTest: async function (test, context, result) {
if (result.error) {
const result = await browser.takeScreenshot();
SlackReporter.uploadFailedTestScreenshot(result);
}
}
}
FAQs
Reporter from WebdriverIO using Incoming webhook and Web API to send results to Slack.
The npm package @moroo/wdio-slack-reporter receives a total of 6,864 weekly downloads. As such, @moroo/wdio-slack-reporter popularity was classified as popular.
We found that @moroo/wdio-slack-reporter demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Ransomware payment rates hit an all-time low in 2024 as law enforcement crackdowns, stronger defenses, and shifting policies make attacks riskier and less profitable.
Security News
require(esm) backported to Node.js 20, easing the transition to ESM-only packages and reducing complexity for developers as Node 18 nears end-of-life.
Security News
PyPI now supports iOS and Android wheels, making it easier for Python developers to distribute mobile packages.