console-fail-test
Gently fails test runs if the console was used during them. π’
Why?
Logging to the console during tests can be a sign of:
- π« warnings from third-party libraries such as React for improper usage
- π€ temporary code that shouldn't be checked into your project
- π’ unnecessary spam in your tests window
This little library throws an error after each test if a console method was called during it. It's got some nifty features:
- π Summary of which methods are called with calling arguments
- π« Failures are thrown after tests finish, so your tests will fail normally if they should
stdout | src/index.test.ts > index > example test that console.logs
Whoopsies!
β― src/index.test.ts (4)
β― index (4)
Γ example test that console.logs
β [ afterEach ]
β example test that does not console.log
β―β―β―β―β―β―β―β―β―β―β―β―β―β―β―- Failed Tests 1 β―β―β―β―β―β―β―β―β―β―β―β―β―β―β―-
FAIL src/index.test.ts > index > example test that console.logs
Error: Oh no! Your test called the following console method:
* log (1 call)
> Call 0: "Whoopsies!"
Usage
console-fail-test is meant to support any (test framework) & (spy library) combination.
It will auto-detect your combination if possible and use the most appropriate environment hooks and function spies it can find.
For example, in a Jest config:
// jest.config.js
module.exports = {
setupFilesAfterEnv: ["console-fail-test/setup.js"],
};Test Frameworks
See the Documentation link for each supported framework for how to set up console-fail-test with that framework.
| Framework | Support? | API Request | Documentation |
| Ava | β οΈ |
require("ava")
|
Ava.md
|
| Mocha | β οΈ β¨ |
"mocha"
|
Mocha.md
|
| Jasmine | β οΈ β¨ |
"jasmine"
|
Jasmine.md
|
| Jest | β οΈ β¨ |
"jest"
|
Jest.md
|
| lab | β |
exports.lab
|
Lab.md
|
| node-tap | β οΈ |
require("node-tap")
|
NodeTap.md
|
| Vitest | β οΈ β¨ |
"vitest"
|
Vitest.md
|
| Cypress | βοΈ |
/issues/199
|
|
| QUnit | βοΈ |
/issues/19
|
|
| Playwright | βοΈ |
/issues/198
|
|
| tape | βοΈ |
/issues/17
|
|
| TestCafe | βοΈ |
/issues/15
|
Spy Libraries
If your test framework provides its own spy library, console-fail-test will by default use that library.
If a supported spy library isn't detected, an internal fallback will be used to spy on console methods.
You can request a specific test library using the Node API with its API request:
require("console-fail-test").cft({
spyLibrary: "sinon",
});| Library | Support? | API Request | Spy | Documentation |
| Jasmine | β οΈ |
"jasmine"
|
jasmine.createSpy()
|
Jasmine.md#spies
|
| Jest | β οΈ |
"jest"
|
jest.fn()
|
Jest.md#spies
|
| Sinon | β οΈ |
require("sinon")
|
sinon.spy()
|
Sinon.md#spies
|
| Vitest | β οΈ |
"vitest"
|
vi.fn()
|
Vitest.md#spies
|
Ignoring console methods
By default, console-fail-test will error on any called console method.
If you'd like allow certain methods, pass a console object to the cft API when you set it up:
require("console-fail-test").cft({
console: {
warn: true, // won't error on any instance of console.warn
},
});Development
Requires:
After forking the repo from GitHub:
git clone https://github.com/<your-name-here>/console-fail-test
cd console-fail-test
yarnContribution Guidelines
We'd love to have you contribute!
Check the issue tracker for issues labeled accepting prs to find bug fixes and feature requests the community can work on.
If this is your first time working with this code, the good first issue label indicates good introductory issues.
Please note that this project is released with a Contributor Covenant. By participating in this project you agree to abide by its terms. See CODE_OF_CONDUCT.md.
Contributors
 Colin MacKenzie π» π€ |
 Dimitri Kopriwa π» |
 Josh Goldberg π§ π» π§ π π€ |
 SUZUKI Sosuke π» |
π This package is based on @JoshuaKGoldberg's create-typescript-app.
![allcontributors[bot] avatar](https://avatars.githubusercontent.com/in/23186?v=4 "allcontributors[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![greenkeeper[bot] avatar](https://avatars.githubusercontent.com/in/505?v=4 "greenkeeper[bot]")
![renovate[bot] avatar](https://avatars.githubusercontent.com/in/2740?v=4 "renovate[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent