2024-08-09 12:04:48 +00:00
|
|
|
/**
|
|
|
|
* @fileoverview Rule to ensure newline per method call when chaining calls
|
|
|
|
* @author Rajendra Patil
|
|
|
|
* @author Burak Yigit Kaya
|
2024-08-21 06:34:30 +00:00
|
|
|
* @deprecated in ESLint v8.53.0
|
2024-08-09 12:04:48 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
"use strict";
|
|
|
|
|
|
|
|
const astUtils = require("./utils/ast-utils");
|
|
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
// Rule Definition
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
|
2024-08-21 06:34:30 +00:00
|
|
|
/** @type {import('../shared/types').Rule} */
|
2024-08-09 12:04:48 +00:00
|
|
|
module.exports = {
|
|
|
|
meta: {
|
2024-08-21 06:34:30 +00:00
|
|
|
deprecated: true,
|
|
|
|
replacedBy: [],
|
2024-08-09 12:04:48 +00:00
|
|
|
type: "layout",
|
|
|
|
|
|
|
|
docs: {
|
2024-08-21 06:34:30 +00:00
|
|
|
description: "Require a newline after each call in a method chain",
|
2024-08-09 12:04:48 +00:00
|
|
|
recommended: false,
|
2024-08-21 06:34:30 +00:00
|
|
|
url: "https://eslint.org/docs/latest/rules/newline-per-chained-call"
|
2024-08-09 12:04:48 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
fixable: "whitespace",
|
|
|
|
|
|
|
|
schema: [{
|
|
|
|
type: "object",
|
|
|
|
properties: {
|
|
|
|
ignoreChainWithDepth: {
|
|
|
|
type: "integer",
|
|
|
|
minimum: 1,
|
|
|
|
maximum: 10,
|
|
|
|
default: 2
|
|
|
|
}
|
|
|
|
},
|
|
|
|
additionalProperties: false
|
|
|
|
}],
|
|
|
|
messages: {
|
|
|
|
expected: "Expected line break before `{{callee}}`."
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
|
|
|
create(context) {
|
|
|
|
|
|
|
|
const options = context.options[0] || {},
|
|
|
|
ignoreChainWithDepth = options.ignoreChainWithDepth || 2;
|
|
|
|
|
2024-08-21 06:34:30 +00:00
|
|
|
const sourceCode = context.sourceCode;
|
2024-08-09 12:04:48 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the prefix of a given MemberExpression node.
|
|
|
|
* If the MemberExpression node is a computed value it returns a
|
|
|
|
* left bracket. If not it returns a period.
|
2024-08-21 06:34:30 +00:00
|
|
|
* @param {ASTNode} node A MemberExpression node to get
|
2024-08-09 12:04:48 +00:00
|
|
|
* @returns {string} The prefix of the node.
|
|
|
|
*/
|
|
|
|
function getPrefix(node) {
|
|
|
|
if (node.computed) {
|
|
|
|
if (node.optional) {
|
|
|
|
return "?.[";
|
|
|
|
}
|
|
|
|
return "[";
|
|
|
|
}
|
|
|
|
if (node.optional) {
|
|
|
|
return "?.";
|
|
|
|
}
|
|
|
|
return ".";
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets the property text of a given MemberExpression node.
|
|
|
|
* If the text is multiline, this returns only the first line.
|
|
|
|
* @param {ASTNode} node A MemberExpression node to get.
|
|
|
|
* @returns {string} The property text of the node.
|
|
|
|
*/
|
|
|
|
function getPropertyText(node) {
|
|
|
|
const prefix = getPrefix(node);
|
|
|
|
const lines = sourceCode.getText(node.property).split(astUtils.LINEBREAK_MATCHER);
|
|
|
|
const suffix = node.computed && lines.length === 1 ? "]" : "";
|
|
|
|
|
|
|
|
return prefix + lines[0] + suffix;
|
|
|
|
}
|
|
|
|
|
|
|
|
return {
|
|
|
|
"CallExpression:exit"(node) {
|
|
|
|
const callee = astUtils.skipChainExpression(node.callee);
|
|
|
|
|
|
|
|
if (callee.type !== "MemberExpression") {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
let parent = astUtils.skipChainExpression(callee.object);
|
|
|
|
let depth = 1;
|
|
|
|
|
|
|
|
while (parent && parent.callee) {
|
|
|
|
depth += 1;
|
|
|
|
parent = astUtils.skipChainExpression(astUtils.skipChainExpression(parent.callee).object);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (depth > ignoreChainWithDepth && astUtils.isTokenOnSameLine(callee.object, callee.property)) {
|
|
|
|
const firstTokenAfterObject = sourceCode.getTokenAfter(callee.object, astUtils.isNotClosingParenToken);
|
|
|
|
|
|
|
|
context.report({
|
|
|
|
node: callee.property,
|
|
|
|
loc: {
|
|
|
|
start: firstTokenAfterObject.loc.start,
|
|
|
|
end: callee.loc.end
|
|
|
|
},
|
|
|
|
messageId: "expected",
|
|
|
|
data: {
|
|
|
|
callee: getPropertyText(callee)
|
|
|
|
},
|
|
|
|
fix(fixer) {
|
|
|
|
return fixer.insertTextBefore(firstTokenAfterObject, "\n");
|
|
|
|
}
|
|
|
|
});
|
|
|
|
}
|
|
|
|
}
|
|
|
|
};
|
|
|
|
}
|
|
|
|
};
|