☕️ Classic, reliable, trusted test framework for Node.js and the browser
About Mocha's Tests
- All assertions should be made using unexpected, unless there's a good reason not to. Exceptions include:
- Testing diff output. Mocha generates diff output unless the assertion library decides to do this itself. Since
unexpectedgenerates its own diff output, we need to use an assertion library that does not; we use the built-inassertmodule. test/unit/runnable.spec.cjsmust avoid 3rd-party code; read source for more info- Tests asserting interop with other specific assertion libraries.
- Testing diff output. Mocha generates diff output unless the assertion library decides to do this itself. Since
- All tests have extension
.spec.js. - All test fixtures have extension
.fixture.js. - All test fixtures are ignored by ESLint.
mocha.optswill requiretest/setup.cjs, which is the main harness.test/assertions.cjscontains Mocha-specific types and assertions forunexpectedtest/node-unit/only runs in Node.js;test/browser-specific/only runs in the browser.- See
./browser/config.jsfor the list of suites that run in the browser via Playwright.
- See
- We can't run all of the Node.js tests in one
mochacommand, because we need to use different command-line options to test the various reporters and interfaces.- See
../package-scripts.jsfor more info about how things are split up.
- See