jest-plugin-must-assert

jest-plugin-must-assert

A plugin extending the default Jest behavior to fail any tests which do not perform a runtime assertion.

Install

npm i -D jest-plugin-must-assert

For default behavior, add the plugin to your setup files.

...
setupFilesAfterEnv: ['jest-plugin-must-assert'],
...

You may also extend the default behavior with the following, manual configuration.

// <rootDir>/must-assert-setup.js
const mustAssert = require('jest-plugin-must-assert/manual');

mustAssert({
  message: 'Please see https://jestjs.io/docs/en/asynchronous for details on testing async code.'
});

Then in your config file:

...
setupFilesAfterEnv: [
  '<rootDir>/must-assert-setup'
],
...

Problem

Static analysis is not enough to catch mistakes in asynchronous tests. For this, we require a runtime check that some assertion was ran during the test.