Error Codes
When Mocha itself throws exception, the associated Error will have a code property.
Where applicable, consumers should check the code property instead of string-matching against the message property.
The following table describes these error codes:
| Code | Description |
|---|---|
ERR_MOCHA_FATAL | an unrecoverable error occurred |
ERR_MOCHA_FORBIDDEN_EXCLUSIVITY | .only() was used with --forbid-only |
ERR_MOCHA_INSTANCE_ALREADY_DISPOSED | run() was called on a Mocha instance that has already been disposed |
ERR_MOCHA_INSTANCE_ALREADY_RUNNING | run() was called on a Mocha instance that is already running |
ERR_MOCHA_INVALID_ARG_TYPE | wrong type was passed for a given argument |
ERR_MOCHA_INVALID_ARG_VALUE | invalid or unsupported value was passed for a given argument |
ERR_MOCHA_INVALID_EXCEPTION | a falsy or otherwise underspecified exception was thrown |
ERR_MOCHA_INVALID_INTERFACE | interface specified in options not found |
ERR_MOCHA_INVALID_PLUGIN_DEFINITION | a plugin definition (e.g., mochaHooks) was invalid |
ERR_MOCHA_INVALID_PLUGIN_IMPLEMENTATION | a user-supplied plugin implementation was invalid |
ERR_MOCHA_INVALID_REPORTER | reporter specified in options not found |
ERR_MOCHA_MULTIPLE_DONE | done() was called multiple times in a test or hook |
ERR_MOCHA_NO_FILES_MATCH_PATTERN | test file(s) could not be found |
ERR_MOCHA_TIMEOUT | a test or hook exceeded its allowed run time |
ERR_MOCHA_UNPARSABLE_FILE | a configuration or test file could not be parsed |
ERR_MOCHA_UNSUPPORTED | requested behavior, option, or parameter is unsupported |