tools: allow RegExp in required-modules eslint rule

PR-URL: #27647
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Michaël Zasso <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>

Author: richardlau

test/.eslintrc.yaml

@@ -21,7 +21,9 @@ rules:
   node-core/inspector-check: error
   node-core/number-isnan: error
   ## common module is mandatory in tests
-  node-core/required-modules: [error, common]
+  node-core/required-modules:
+    - error
+    - common: 'common(/index\.(m)?js)?$'
   node-core/require-common-first: error
   node-core/no-duplicate-requires: off
 

test/parallel/test-eslint-required-modules.js

@@ -13,22 +13,38 @@ new RuleTester().run('required-modules', rule, {
   valid: [
     {
       code: 'require("common")',
-      options: ['common']
+      options: [{ common: 'common' }]
     },
     {
       code: 'foo',
       options: []
     },
+    {
+      code: 'require("common")',
+      options: [{ common: 'common(/index\\.(m)?js)?$' }]
+    },
+    {
+      code: 'require("common/index.js")',
+      options: [{ common: 'common(/index\\.(m)?js)?$' }]
+    },
   ],
   invalid: [
     {
       code: 'foo',
-      options: ['common'],
+      options: [{ common: 'common' }],
       errors: [{ message: 'Mandatory module "common" must be loaded.' }]
     },
+    {
+      code: 'require("common/fixtures.js")',
+      options: [{ common: 'common(/index\\.(m)?js)?$' }],
+      errors: [{
+        message:
+          'Mandatory module "common" must be loaded.'
+      }]
+    },
     {
       code: 'require("somethingElse")',
-      options: ['common'],
+      options: [{ common: 'common' }],
       errors: [{ message: 'Mandatory module "common" must be loaded.' }]
     }
   ]

tools/eslint-rules/required-modules.js

@@ -4,15 +4,16 @@
  */
 'use strict';
 
-const path = require('path');
-
 //------------------------------------------------------------------------------
 // Rule Definition
 //------------------------------------------------------------------------------
 
 module.exports = function(context) {
   // Trim required module names
-  const requiredModules = context.options;
+  const options = context.options[0];
+  const requiredModules = options ? Object.keys(options).map((x) => {
+    return [ x, new RegExp(options[x]) ];
+  }) : [];
   const isESM = context.parserOptions.sourceType === 'module';
 
   const foundModules = [];
@@ -46,14 +47,10 @@ module.exports = function(context) {
    * @returns {undefined|String} required module name or undefined
    */
   function getRequiredModuleName(str) {
-    if (str === '../common/index.mjs') {
-      return 'common';
-    }
-
-    const value = path.basename(str);
-
-    // Check if value is in required modules array
-    return requiredModules.indexOf(value) !== -1 ? value : undefined;
+    const match = requiredModules.find(([, test]) => {
+      return test.test(str);
+    });
+    return match ? match[0] : undefined;
   }
 
   /**
@@ -75,9 +72,9 @@ module.exports = function(context) {
     'Program:exit'(node) {
       if (foundModules.length < requiredModules.length) {
         const missingModules = requiredModules.filter(
-          (module) => foundModules.indexOf(module) === -1
+          ([module]) => foundModules.indexOf(module) === -1
         );
-        missingModules.forEach((moduleName) => {
+        missingModules.forEach(([moduleName]) => {
           context.report(
             node,
             'Mandatory module "{{moduleName}}" must be loaded.',
@@ -110,10 +107,11 @@ module.exports = function(context) {
   return rules;
 };
 
-module.exports.schema = {
-  'type': 'array',
-  'additionalItems': {
-    'type': 'string'
-  },
-  'uniqueItems': true
+module.exports.meta = {
+  schema: [{
+    'type': 'object',
+    'additionalProperties': {
+      'type': 'string'
+    },
+  }],
 };