fail-on-console 1.1.1 → 1.1.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.1.2](https://github.com/benquarmby/fail-on-console/compare/v1.1.1...v1.1.2) (2026-07-22)
+
+
+### Bug Fixes
+
+* guard against invalid and unsupported console methods ([504fa30](https://github.com/benquarmby/fail-on-console/commit/504fa301e245d0965afdfaf3c31d2d3b9a0cb10c))
+
 ## [1.1.1](https://github.com/benquarmby/fail-on-console/compare/v1.1.0...v1.1.1) (2026-07-08)
 
 

package/README.md

@@ -112,8 +112,18 @@ Registers a temporary or global allowlist rule for a monitored console method.
 
 ## Limitations
 
+### Concurrency
+
 `fail-on-console` is not compatible with concurrent asynchronous tests (e.g., `test.concurrent`). Because concurrent tests execute simultaneously within the same environment context, console logs cannot be isolated reliably per individual test. For suites requiring specific log suppression, tests must be run sequentially.
 
+### Assert
+
+Monitoring `console.assert` is currently unsupported. It has a distinct signature and unique assertion mechanics compared to standard logging methods.
+
+### Mocha
+
+Mocha is unsupported due to API incompatibilities related to test context. There are no clean or reliable workarounds for integration.
+
 ## Credits & Prior Art
 
 This package is inspired by and builds on the excellent foundation laid by:

package/index.js

@@ -1,9 +1,36 @@
 let testApi;
-const defaultMethods = ["error", "warn", "info", "log"];
+const supportedMethods = ["error", "warn", "info", "log", "debug"];
+// Everything but console.debug is monitored by default. Debug logging in tests
+// is usually intentional.
+const defaultMethods = supportedMethods.slice(0, -1);
 const allowed = new Map();
 // %s string, %d/%i integer, %o object, %f float
 const printfPattern = /%[sdiof]/g;
 
+function quoteString(value) {
+    return `"${value}"`;
+}
+
+function assertSupportedMethods(methods) {
+    if (!Array.isArray(methods)) {
+        throw new Error("fail-on-console: Expected an array of console methods.");
+    }
+
+    const unsupported = methods.filter((method) => !supportedMethods.includes(method));
+
+    if (!unsupported.length) {
+        return;
+    }
+
+    const method = unsupported.length === 1 ? "method" : "methods";
+    const invalidList = unsupported.map(quoteString).join(", ");
+    const validList = supportedMethods.map(quoteString).join(", ");
+
+    throw new Error(
+        `fail-on-console: Unsupported console ${method} provided: ${invalidList}. Supported methods are: ${validList}.`
+    );
+}
+
 /**
  * Basic implementation of node:util/format for console message formatting.
  * Covers only the most common uses. Does not handle all specifiers (such as
@@ -51,6 +78,8 @@ function setupConsole({beforeEach, afterEach, expect, methods = defaultMethods})
         throw new Error("fail-on-console: Call setupConsole() only once.");
     }
 
+    assertSupportedMethods(methods);
+
     testApi = {beforeEach, afterEach, expect};
 
     beforeEach(() => allowed.clear());
@@ -98,6 +127,8 @@ function allowConsole(method, rules) {
         throw new Error("fail-on-console: Call setupConsole() before using allowConsole().");
     }
 
+    assertSupportedMethods([method]);
+
     const normalized = Array.isArray(rules) ? rules : [rules];
     const isInsideTest = !!testApi.expect.getState().currentTestName;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fail-on-console",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Fail Vitest or Jest tests when unexpected console logs, warnings or errors occur.",
   "keywords": [
     "jest",