122 lines
3.4 KiB
JavaScript
122 lines
3.4 KiB
JavaScript
/**
|
|
* @fileoverview A rule to warn against using arrow functions when they could be
|
|
* confused with comparisons
|
|
* @author Jxck <https://github.com/Jxck>
|
|
* @deprecated in ESLint v8.53.0
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
const astUtils = require('./utils/ast-utils.js');
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Helpers
|
|
//------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Checks whether or not a node is a conditional expression.
|
|
* @param {ASTNode} node node to test
|
|
* @returns {boolean} `true` if the node is a conditional expression.
|
|
*/
|
|
function isConditional(node) {
|
|
return node && node.type === 'ConditionalExpression';
|
|
}
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Rule Definition
|
|
//------------------------------------------------------------------------------
|
|
|
|
/** @type {import('../types').Rule.RuleModule} */
|
|
module.exports = {
|
|
meta: {
|
|
deprecated: {
|
|
message: 'Formatting rules are being moved out of ESLint core.',
|
|
url: 'https://eslint.org/blog/2023/10/deprecating-formatting-rules/',
|
|
deprecatedSince: '8.53.0',
|
|
availableUntil: '10.0.0',
|
|
replacedBy: [
|
|
{
|
|
message:
|
|
'ESLint Stylistic now maintains deprecated stylistic core rules.',
|
|
url: 'https://eslint.style/guide/migration',
|
|
plugin: {
|
|
name: '@stylistic/eslint-plugin-js',
|
|
url: 'https://eslint.style/packages/js',
|
|
},
|
|
rule: {
|
|
name: 'no-confusing-arrow',
|
|
url: 'https://eslint.style/rules/js/no-confusing-arrow',
|
|
},
|
|
},
|
|
],
|
|
},
|
|
type: 'suggestion',
|
|
|
|
docs: {
|
|
description:
|
|
'Disallow arrow functions where they could be confused with comparisons',
|
|
recommended: false,
|
|
url: 'https://eslint.org/docs/latest/rules/no-confusing-arrow',
|
|
},
|
|
|
|
fixable: 'code',
|
|
|
|
schema: [
|
|
{
|
|
type: 'object',
|
|
properties: {
|
|
allowParens: { type: 'boolean', default: true },
|
|
onlyOneSimpleParam: { type: 'boolean', default: false },
|
|
},
|
|
additionalProperties: false,
|
|
},
|
|
],
|
|
|
|
messages: {
|
|
confusing:
|
|
'Arrow function used ambiguously with a conditional expression.',
|
|
},
|
|
},
|
|
|
|
create(context) {
|
|
const config = context.options[0] || {};
|
|
const allowParens = config.allowParens || config.allowParens === void 0;
|
|
const onlyOneSimpleParam = config.onlyOneSimpleParam;
|
|
const sourceCode = context.sourceCode;
|
|
|
|
/**
|
|
* Reports if an arrow function contains an ambiguous conditional.
|
|
* @param {ASTNode} node A node to check and report.
|
|
* @returns {void}
|
|
*/
|
|
function checkArrowFunc(node) {
|
|
const body = node.body;
|
|
|
|
if (
|
|
isConditional(body) &&
|
|
!(allowParens && astUtils.isParenthesised(sourceCode, body)) &&
|
|
!(
|
|
onlyOneSimpleParam &&
|
|
!(node.params.length === 1 && node.params[0].type === 'Identifier')
|
|
)
|
|
) {
|
|
context.report({
|
|
node,
|
|
messageId: 'confusing',
|
|
fix(fixer) {
|
|
// if `allowParens` is not set to true don't bother wrapping in parens
|
|
return (
|
|
allowParens &&
|
|
fixer.replaceText(node.body, `(${sourceCode.getText(node.body)})`)
|
|
);
|
|
},
|
|
});
|
|
}
|
|
}
|
|
|
|
return {
|
|
ArrowFunctionExpression: checkArrowFunc,
|
|
};
|
|
},
|
|
};
|