console-fail-test

console-fail-test

Gently fails test runs if the console was used during them.

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.

In general, you can use the Node API to request specific test frameworks and spy libraries:

require("console-fail-test").cft({
    testFramework: "jest",
    spyLibrary: "jasmine",
});

Test Frameworks

Test frameworks that are ✨ auto-detectable can be supported by just running console-fail-test/setup.js before tests. For others, use the Node API with their API request:

require("console-fail-test").cft({
    testFramework: require("ava"),
});

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
QUnit	⚙️		/issues/19
tape	⚙️		/issues/17
TestCafe	⚙️		/issues/15

See open test framework support issues for progress!

Spy Libraries

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
Jest	✅️	"jest"	jest.fn()	Jest.md
Sinon	✅️	require("sinon")	sinon.spy()	Sinon.md

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
    },
});

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

Look how fancy the terminal output is with Jest!