/** * @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 }, }); } } } } }, }; }, };