it.fails() - allow failing mocha testsnpm install --save-dev it-fails
Similar to in ava, you can use the .fails modifier to document issues with your code that need to be fixed. Failing tests are run just like normal ones, but they are expected to fail, and will not break your build when they do. If a test marked as failing actually passes, it will be reported as an error and fail the build. Once a test is passing you can should remove the .fails modifier.
This allows you to merge failing tests before a fix is implemented without breaking CI. This is a great way to recognize good bug report PR's with a commit credit, even if the reporter is unable to actually fix the problem.
Require the module, then use it.fails like you would it.only or it.skip.
require('it-fails');
it.fails('a test that will fail', function() {
throw new Error('oops')
});
The base reporter's epilogue is also overwritten by this module to show a summary that is aware of expected failures. The epilogue now shows skipped tests in addition to failures.
You can optionally set test.details (test is returned from it), which will display additional text when the test is printed out. This can be used to display an issue associated with a failing test or the reason for a test being skipped.
Run npm run demo to see the output from the screenshot above. Also check out npm run demo2 and npm run demo3.
FAQs
[](https://travis-ci.org/mlrawlings/it-fails)
The npm package it-fails receives a total of 179 weekly downloads. As such, it-fails popularity was classified as not popular.
We found that it-fails demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers 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
Critics call the Node.js EOL CVE a misuse of the system, sparking debate over CVE standards and the growing noise in vulnerability databases.
Security News
cURL and Go security teams are publicly rejecting CVSS as flawed for assessing vulnerabilities and are calling for more accurate, context-aware approaches.
Security News
Bun 1.2 enhances its JavaScript runtime with 90% Node.js compatibility, built-in S3 and Postgres support, HTML Imports, and faster, cloud-first performance.