mirror of
https://github.com/nodejs/node.git
synced 2024-11-21 10:59:27 +00:00
8aa3ce8b59
These changes are in preparation for enabling a JSDoc lint rule. PR-URL: https://github.com/nodejs/node/pull/41109 Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: Michaël Zasso <targos@protonmail.com> Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
101 lines
2.9 KiB
JavaScript
101 lines
2.9 KiB
JavaScript
/**
|
|
* Utility functions common to ESLint rules.
|
|
*/
|
|
'use strict';
|
|
|
|
function isRequireCall(node) {
|
|
return node.callee.type === 'Identifier' && node.callee.name === 'require';
|
|
}
|
|
module.exports.isRequireCall = isRequireCall;
|
|
|
|
module.exports.isString = function(node) {
|
|
return node && node.type === 'Literal' && typeof node.value === 'string';
|
|
};
|
|
|
|
module.exports.isDefiningError = function(node) {
|
|
return node.expression &&
|
|
node.expression.type === 'CallExpression' &&
|
|
node.expression.callee &&
|
|
node.expression.callee.name === 'E' &&
|
|
node.expression.arguments.length !== 0;
|
|
};
|
|
|
|
/**
|
|
* Returns true if any of the passed in modules are used in
|
|
* require calls.
|
|
*/
|
|
module.exports.isRequired = function(node, modules) {
|
|
return isRequireCall(node) && node.arguments.length !== 0 &&
|
|
modules.includes(node.arguments[0].value);
|
|
};
|
|
|
|
/**
|
|
* Return true if common module is required
|
|
* in AST Node under inspection
|
|
*/
|
|
const commonModuleRegExp = new RegExp(/^(\.\.\/)*common(\.js)?$/);
|
|
module.exports.isCommonModule = function(node) {
|
|
return isRequireCall(node) &&
|
|
node.arguments.length !== 0 &&
|
|
commonModuleRegExp.test(node.arguments[0].value);
|
|
};
|
|
|
|
/**
|
|
* Returns true if any of the passed in modules are used in
|
|
* process.binding() or internalBinding() calls.
|
|
*/
|
|
module.exports.isBinding = function(node, modules) {
|
|
const isProcessBinding = node.callee.object &&
|
|
node.callee.object.name === 'process' &&
|
|
node.callee.property.name === 'binding';
|
|
|
|
return (isProcessBinding || node.callee.name === 'internalBinding') &&
|
|
modules.includes(node.arguments[0].value);
|
|
};
|
|
|
|
/**
|
|
* Returns true is the node accesses any property in the properties
|
|
* array on the 'common' object.
|
|
*/
|
|
module.exports.usesCommonProperty = function(node, properties) {
|
|
if (node.name) {
|
|
return properties.includes(node.name);
|
|
}
|
|
if (node.property) {
|
|
return properties.includes(node.property.name);
|
|
}
|
|
return false;
|
|
};
|
|
|
|
/**
|
|
* Returns true if the passed in node is inside an if statement block,
|
|
* and the block also has a call to skip.
|
|
*/
|
|
module.exports.inSkipBlock = function(node) {
|
|
let hasSkipBlock = false;
|
|
if (node.test &&
|
|
node.test.type === 'UnaryExpression' &&
|
|
node.test.operator === '!') {
|
|
const consequent = node.consequent;
|
|
if (consequent.body) {
|
|
consequent.body.some((expressionStatement) => {
|
|
if (hasSkip(expressionStatement.expression)) {
|
|
return hasSkipBlock = true;
|
|
}
|
|
return false;
|
|
});
|
|
} else if (hasSkip(consequent.expression)) {
|
|
hasSkipBlock = true;
|
|
}
|
|
}
|
|
return hasSkipBlock;
|
|
};
|
|
|
|
function hasSkip(expression) {
|
|
return expression &&
|
|
expression.callee &&
|
|
(expression.callee.name === 'skip' ||
|
|
expression.callee.property &&
|
|
expression.callee.property.name === 'skip');
|
|
}
|