/** * @fileoverview Restrict usage of specified node modules. * @author Christian Schulz * @deprecated in ESLint v7.0.0 */ "use strict"; //------------------------------------------------------------------------------ // Requirements //------------------------------------------------------------------------------ const astUtils = require("./utils/ast-utils"); //------------------------------------------------------------------------------ // Rule Definition //------------------------------------------------------------------------------ const ignore = require("ignore"); const arrayOfStrings = { type: "array", items: { type: "string" }, uniqueItems: true, }; const arrayOfStringsOrObjects = { type: "array", items: { anyOf: [ { type: "string" }, { type: "object", properties: { name: { type: "string" }, message: { type: "string", minLength: 1, }, }, additionalProperties: false, required: ["name"], }, ], }, uniqueItems: true, }; /** @type {import('../types').Rule.RuleModule} */ module.exports = { meta: { deprecated: { message: "Node.js rules were moved out of ESLint core.", url: "https://eslint.org/docs/latest/use/migrating-to-7.0.0#deprecate-node-rules", deprecatedSince: "7.0.0", availableUntil: null, replacedBy: [ { message: "eslint-plugin-n now maintains deprecated Node.js-related rules.", plugin: { name: "eslint-plugin-n", url: "https://github.com/eslint-community/eslint-plugin-n", }, rule: { name: "no-restricted-require", url: "https://github.com/eslint-community/eslint-plugin-n/tree/master/docs/rules/no-restricted-require.md", }, }, ], }, type: "suggestion", docs: { description: "Disallow specified modules when loaded by `require`", recommended: false, url: "https://eslint.org/docs/latest/rules/no-restricted-modules", }, schema: { anyOf: [ arrayOfStringsOrObjects, { type: "array", items: { type: "object", properties: { paths: arrayOfStringsOrObjects, patterns: arrayOfStrings, }, additionalProperties: false, }, additionalItems: false, }, ], }, messages: { defaultMessage: "'{{name}}' module is restricted from being used.", customMessage: // eslint-disable-next-line eslint-plugin/report-message-format -- Custom message might not end in a period "'{{name}}' module is restricted from being used. {{customMessage}}", patternMessage: "'{{name}}' module is restricted from being used by a pattern.", }, }, create(context) { const options = Array.isArray(context.options) ? context.options : []; const isPathAndPatternsObject = typeof options[0] === "object" && (Object.hasOwn(options[0], "paths") || Object.hasOwn(options[0], "patterns")); const restrictedPaths = (isPathAndPatternsObject ? options[0].paths : context.options) || []; const restrictedPatterns = (isPathAndPatternsObject ? options[0].patterns : []) || []; const restrictedPathMessages = restrictedPaths.reduce( (memo, importName) => { if (typeof importName === "string") { memo[importName] = null; } else { memo[importName.name] = importName.message; } return memo; }, {}, ); // if no imports are restricted we don't need to check if ( Object.keys(restrictedPaths).length === 0 && restrictedPatterns.length === 0 ) { return {}; } // relative paths are supported for this rule const ig = ignore({ allowRelativePaths: true }).add(restrictedPatterns); /** * Function to check if a node is a string literal. * @param {ASTNode} node The node to check. * @returns {boolean} If the node is a string literal. */ function isStringLiteral(node) { return ( node && node.type === "Literal" && typeof node.value === "string" ); } /** * Function to check if a node is a require call. * @param {ASTNode} node The node to check. * @returns {boolean} If the node is a require call. */ function isRequireCall(node) { return ( node.callee.type === "Identifier" && node.callee.name === "require" ); } /** * Extract string from Literal or TemplateLiteral node * @param {ASTNode} node The node to extract from * @returns {string|null} Extracted string or null if node doesn't represent a string */ function getFirstArgumentString(node) { if (isStringLiteral(node)) { return node.value.trim(); } if (astUtils.isStaticTemplateLiteral(node)) { return node.quasis[0].value.cooked.trim(); } return null; } /** * Report a restricted path. * @param {node} node representing the restricted path reference * @param {string} name restricted path * @returns {void} * @private */ function reportPath(node, name) { const customMessage = restrictedPathMessages[name]; const messageId = customMessage ? "customMessage" : "defaultMessage"; context.report({ node, messageId, data: { name, customMessage, }, }); } /** * Check if the given name is a restricted path name * @param {string} name name of a variable * @returns {boolean} whether the variable is a restricted path or not * @private */ function isRestrictedPath(name) { return Object.hasOwn(restrictedPathMessages, name); } return { CallExpression(node) { if (isRequireCall(node)) { // node has arguments if (node.arguments.length) { const name = getFirstArgumentString(node.arguments[0]); // if first argument is a string literal or a static string template literal if (name) { // check if argument value is in restricted modules array if (isRestrictedPath(name)) { reportPath(node, name); } if ( restrictedPatterns.length > 0 && ig.ignores(name) ) { context.report({ node, messageId: "patternMessage", data: { name }, }); } } } } }, }; }, };