---
name: "mocha"
section: "1"
platform: "linux"
package: "mocha"
version: "10.7.2+ds1+~cs33.1.11-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mocha"
---

# mocha(1)

simple, flexible, fun test framework

## NAME

mocha - simple, flexible, fun test framework

## DESCRIPTION

mocha \[spec..\]

Run tests with Mocha

Commands

- mocha inspect \[spec..\]

  Run tests with Mocha                         \[default\]

- mocha init \<path\>

  create a client-side Mocha setup at \<path\>

Rules & Behavior

- **--allow-uncaught**

  Allow uncaught errors to propagate \[boolean\]

- **-A**, **--async-only**

  Require all tests to use a callback (async) or return a Promise                \[boolean\]

- **-b**, **--bail**

  Abort ("bail") after first test failure \[boolean\]

- **--check-leaks**

  Check for global variable leaks    \[boolean\]

- **--delay**

  Delay initial execution of root suite \[boolean\]

- **--dry-run**

  Report tests without executing them\[boolean\]

- **--exit**

  Force Mocha to quit after tests complete \[boolean\]

- **--pass-on-failing-test-suite**

  Not fail test run if tests were failed \[boolean\] \[default: false\]

- **--fail-zero**

  Fail test run if no test(s) encountered \[boolean\]

- **--forbid-only**

  Fail if exclusive test(s) encountered \[boolean\]

- **--forbid-pending**

  Fail if pending test(s) encountered\[boolean\]

- **--global**, **--globals**

  List of allowed global variables     \[array\]

- **-j**, **--jobs**

  Number of concurrent jobs for **--parallel**; use 1 to run in serial

-

  \[number\] \[default: (number of CPU cores - 1)\]

- **-p**, **--parallel**

  Run tests in parallel              \[boolean\]

- **--retries**

  Retry failed tests this many times  \[number\]

- **-s**, **--slow**

  Specify "slow" test threshold (in milliseconds)         \[string\] \[default: 75\]

- **-t**, **--timeout**, **--timeouts**

  Specify test timeout threshold (in milliseconds)       \[string\] \[default: 2000\]

- **-u**, **--ui**

  Specify user interface \[string\] \[default: "bdd"\]

Reporting & Output

- **-c**, **--color**, **--colors**

  Force-enable color output  \[boolean\]

- **--diff**

  Show diff on failure \[boolean\] \[default: true\]

- **--full-trace**

  Display full stack traces  \[boolean\]

- **--inline-diffs**

  Display actual/expected differences inline within each string  \[boolean\]

- **-R**, **--reporter**

  Specify reporter to use \[string\] \[default: "spec"\]

- **-O**, **--reporter-option**,

  Reporter-specific options

- **--reporter-options**

  (\<k=v,\[k1=v1,..\]\>)           \[array\]

Configuration

- **--config**

  Path to config file   \[string\] \[default: (nearest rc file)\]

- **-n**, **--node-option**

  Node or V8 option (no leading "--")                 \[array\]

- **--package**

  Path to package.json for config                    \[string\]

File Handling

- **--extension**

  File extension(s) to load \[array\] \[default: \["js","cjs","mjs"\]\]

- **--file**

  Specify file(s) to be loaded prior to root suite execution                   \[array\] \[default: (none)\]

- **--ignore**, **--exclude**

  Ignore file(s) or glob pattern(s) \[array\] \[default: (none)\]

- **--recursive**

  Look for tests in subdirectories            \[boolean\]

- **-r**, **--require**

  Require module              \[array\] \[default: (none)\]

- **-S**, **--sort**

  Sort test files                             \[boolean\]

- **-w**, **--watch**

  Watch files in the current working directory for changes                                     \[boolean\]

- **--watch-files**

  List of paths or globs to watch               \[array\]

- **--watch-ignore**

  List of paths or globs to exclude from watching \[array\] \[default: \["node\_modules",".git"\]\]

Test Filters

- **-f**, **--fgrep**

  Only run tests containing this string                   \[string\]

- **-g**, **--grep**

  Only run tests matching this string or regexp           \[string\]

- **-i**, **--invert**

  Inverts **--grep** and **--fgrep** matches                     \[boolean\]

Positional Arguments

- spec

  One or more files, directories, or globs to test

-

  \[array\] \[default: \["test"\]\]

Other Options

- **-h**, **--help**

  Show usage information & exit                 \[boolean\]

- **-V**, **--version**

  Show version number & exit                    \[boolean\]

- **--list-interfaces**

  List built-in user interfaces & exit          \[boolean\]

- **--list-reporters**

  List built-in reporters & exit                \[boolean\]

Mocha Resources

-

  Chat: \[35mhttps://discord.gg/KeDn2uXhER\[39m

-

  GitHub: \[34mhttps://github.com/mochajs/mocha.git\[39m

-

  Docs: \[33mhttps://mochajs.org/\[39m