feat: Add support for ignoring experemental features

lib/rules/no-unsupported-features/node-builtins.js

@@ -37,6 +37,7 @@ module.exports = {
                 type: "object",
                 properties: {
                     version: getConfiguredNodeVersion.schema,
+                    allowExperimental: { type: "boolean" },
                     ignores: {
                         type: "array",
                         items: {

lib/util/check-unsupported-builtins.js

@@ -15,38 +15,43 @@ const semverRangeSubset = require("semver/ranges/subset")
  * Parses the options.
  * @param {import('eslint').Rule.RuleContext} context The rule context.
  * @returns {Readonly<{
- *   version: import('semver').Range,
- *   ignores: Set<string>
+ *   version: import('semver').Range;
+ *   ignores: Set<string>;
+ *   allowExperimental: boolean;
  * }>} Parsed value.
  */
 function parseOptions(context) {
     const raw = context.options[0] || {}
     const version = getConfiguredNodeVersion(context)
     const ignores = new Set(raw.ignores || [])
+    const allowExperimental = raw.allowExperimental ?? false
 
-    return Object.freeze({ version, ignores })
+    return Object.freeze({ version, ignores, allowExperimental })
 }
 
 /**
  * Check if it has been supported.
- * @param {import('../unsupported-features/types.js').SupportInfo} info The support info.
- * @param {import('semver').Range} configured The configured version range.
+ * @param {string[] | undefined} featureRange The target features supported range
+ * @param {import('semver').Range} requestedRange The configured version range.
+ * @returns {boolean}
  */
-function isSupported({ supported }, configured) {
-    if (supported == null || supported.length === 0) {
+function isInRange(featureRange, requestedRange) {
+    if (featureRange == null || featureRange.length === 0) {
         return false
     }
 
-    const [latest] = rsort(supported)
+    const [latest] = rsort(featureRange)
     const range = getSemverRange(
-        [...supported.map(version => `^${version}`), `>= ${latest}`].join("||")
+        [...featureRange.map(version => `^${version}`), `>= ${latest}`].join(
+            "||"
+        )
     )
 
     if (range == null) {
         return false
     }
 
-    return semverRangeSubset(configured, range)
+    return semverRangeSubset(requestedRange, range)
 }
 
 /**
@@ -92,11 +97,14 @@ module.exports.checkUnsupportedBuiltins = function checkUnsupportedBuiltins(
 
     for (const { node, path, info } of references) {
         const name = unprefixNodeColon(path.join("."))
-        const supported = isSupported(info, options.version)
-
-        if (supported === true || options.ignores.has(name)) {
+        if (
+            isInRange(info.supported, options.version) ||
+            options.ignores.has(name) ||
+            (options.allowExperimental === true && info.experimental != null)
+        ) {
             continue
         }
+
         const supportedVersion = supportedVersionToString(info)
         context.report({
             node,

tests/lib/rules/no-unsupported-features/node-builtins.js

@@ -5371,5 +5371,30 @@ new RuleTester({ languageOptions: { sourceType: "module" } }).run(
                 },
             ],
         },
+
+        {
+            valid: [
+                {
+                    code: "fetch('/asd')",
+                    options: [{ version: "16.0.0", allowExperimental: true }],
+                },
+            ],
+            invalid: [
+                {
+                    code: "fetch('/asd')",
+                    options: [{ version: "16.0.0", allowExperimental: false }],
+                    errors: [
+                        {
+                            messageId: "not-supported-till",
+                            data: {
+                                name: "fetch",
+                                supported: "21.0.0",
+                                version: "16.0.0",
+                            },
+                        },
+                    ],
+                },
+            ],
+        },
     ])
 )