eslint-plugin-n 17.23.2 → 17.24.0

package/README.md

@@ -165,9 +165,11 @@ For [Shareable Configs](https://eslint.org/docs/latest/developer-guide/shareable
 | [no-unsupported-features/node-builtins](docs/rules/no-unsupported-features/node-builtins.md) | disallow unsupported Node.js built-in APIs on the specified version         | 🟢 ✅ |    |    |
 | [prefer-global/buffer](docs/rules/prefer-global/buffer.md)                                   | enforce either `Buffer` or `require("buffer").Buffer`                       |      |    |    |
 | [prefer-global/console](docs/rules/prefer-global/console.md)                                 | enforce either `console` or `require("console")`                            |      |    |    |
+| [prefer-global/crypto](docs/rules/prefer-global/crypto.md)                                   | enforce either `crypto` or `require("crypto").webcrypto`                    |      |    |    |
 | [prefer-global/process](docs/rules/prefer-global/process.md)                                 | enforce either `process` or `require("process")`                            |      |    |    |
 | [prefer-global/text-decoder](docs/rules/prefer-global/text-decoder.md)                       | enforce either `TextDecoder` or `require("util").TextDecoder`               |      |    |    |
 | [prefer-global/text-encoder](docs/rules/prefer-global/text-encoder.md)                       | enforce either `TextEncoder` or `require("util").TextEncoder`               |      |    |    |
+| [prefer-global/timers](docs/rules/prefer-global/timers.md)                                   | enforce either global timer functions or `require("timers")`                |      |    |    |
 | [prefer-global/url](docs/rules/prefer-global/url.md)                                         | enforce either `URL` or `require("url").URL`                                |      |    |    |
 | [prefer-global/url-search-params](docs/rules/prefer-global/url-search-params.md)             | enforce either `URLSearchParams` or `require("url").URLSearchParams`        |      |    |    |
 | [prefer-node-protocol](docs/rules/prefer-node-protocol.md)                                   | enforce using the `node:` protocol when importing Node.js builtin modules.  |      | 🔧 |    |

package/lib/all-rules.js

@@ -38,11 +38,13 @@ module.exports = {
     "no-unsupported-features/node-builtins": require("./rules/no-unsupported-features/node-builtins"),
     "prefer-global/buffer": require("./rules/prefer-global/buffer"),
     "prefer-global/console": require("./rules/prefer-global/console"),
+    "prefer-global/crypto": require("./rules/prefer-global/crypto"),
     "prefer-global/process": require("./rules/prefer-global/process"),
     "prefer-global/text-decoder": require("./rules/prefer-global/text-decoder"),
     "prefer-global/text-encoder": require("./rules/prefer-global/text-encoder"),
     "prefer-global/url-search-params": require("./rules/prefer-global/url-search-params"),
     "prefer-global/url": require("./rules/prefer-global/url"),
+    "prefer-global/timers": require("./rules/prefer-global/timers"),
     "prefer-node-protocol": require("./rules/prefer-node-protocol"),
     "prefer-promises/dns": require("./rules/prefer-promises/dns"),
     "prefer-promises/fs": require("./rules/prefer-promises/fs"),

package/lib/rules/prefer-global/crypto.js

@@ -0,0 +1,47 @@
+/**
+ * @author Pixel998
+ * See LICENSE file in root directory for full license.
+ */
+"use strict"
+
+const { READ } = require("@eslint-community/eslint-utils")
+const checkForPreferGlobal = require("../../util/check-prefer-global")
+
+const traceMap = {
+    globals: {
+        crypto: { [READ]: true },
+    },
+    modules: {
+        crypto: { webcrypto: { [READ]: true } },
+        "node:crypto": { webcrypto: { [READ]: true } },
+    },
+}
+
+/** @type {import('../rule-module').RuleModule} */
+module.exports = {
+    meta: {
+        docs: {
+            description:
+                'enforce either `crypto` or `require("crypto").webcrypto`',
+            recommended: false,
+            url: "https://github.com/eslint-community/eslint-plugin-n/blob/HEAD/docs/rules/prefer-global/crypto.md",
+        },
+        type: "suggestion",
+        fixable: null,
+        schema: [{ enum: ["always", "never"] }],
+        messages: {
+            preferGlobal:
+                "Unexpected use of 'require(\"crypto\").webcrypto'. Use the global variable 'crypto' instead.",
+            preferModule:
+                "Unexpected use of the global variable 'crypto'. Use 'require(\"crypto\").webcrypto' instead.",
+        },
+    },
+
+    create(context) {
+        return {
+            "Program:exit"() {
+                checkForPreferGlobal(context, traceMap)
+            },
+        }
+    },
+}

package/lib/rules/prefer-global/timers.js

@@ -0,0 +1,66 @@
+/**
+ * @author Pixel998
+ * See LICENSE file in root directory for full license.
+ */
+"use strict"
+
+const { READ } = require("@eslint-community/eslint-utils")
+const checkForPreferGlobal = require("../../util/check-prefer-global")
+
+const traceMap = {
+    globals: {
+        clearImmediate: { [READ]: true },
+        clearInterval: { [READ]: true },
+        clearTimeout: { [READ]: true },
+        setImmediate: { [READ]: true },
+        setInterval: { [READ]: true },
+        setTimeout: { [READ]: true },
+    },
+    modules: {
+        timers: {
+            clearImmediate: { [READ]: true },
+            clearInterval: { [READ]: true },
+            clearTimeout: { [READ]: true },
+            setImmediate: { [READ]: true },
+            setInterval: { [READ]: true },
+            setTimeout: { [READ]: true },
+        },
+        "node:timers": {
+            clearImmediate: { [READ]: true },
+            clearInterval: { [READ]: true },
+            clearTimeout: { [READ]: true },
+            setImmediate: { [READ]: true },
+            setInterval: { [READ]: true },
+            setTimeout: { [READ]: true },
+        },
+    },
+}
+
+/** @type {import('../rule-module').RuleModule} */
+module.exports = {
+    meta: {
+        docs: {
+            description:
+                'enforce either global timer functions or `require("timers")`',
+            recommended: false,
+            url: "https://github.com/eslint-community/eslint-plugin-n/blob/HEAD/docs/rules/prefer-global/timers.md",
+        },
+        type: "suggestion",
+        fixable: null,
+        schema: [{ enum: ["always", "never"] }],
+        messages: {
+            preferGlobal:
+                "Unexpected use of 'require(\"timers\").*'. Use the global variable instead.",
+            preferModule:
+                "Unexpected use of the global variable. Use 'require(\"timers\").*' instead.",
+        },
+    },
+
+    create(context) {
+        return {
+            "Program:exit"() {
+                checkForPreferGlobal(context, traceMap)
+            },
+        }
+    },
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "eslint-plugin-n",
-    "version": "17.23.2",
+    "version": "17.24.0",
     "description": "Additional ESLint's rules for Node.js",
     "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"