160 lines
3.8 KiB
JavaScript
160 lines
3.8 KiB
JavaScript
/**
|
|
* @fileoverview Rule to ensure newline per method call when chaining calls
|
|
* @author Rajendra Patil
|
|
* @author Burak Yigit Kaya
|
|
* @deprecated in ESLint v8.53.0
|
|
*/
|
|
|
|
"use strict";
|
|
|
|
const astUtils = require("./utils/ast-utils");
|
|
|
|
//------------------------------------------------------------------------------
|
|
// 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: "newline-per-chained-call",
|
|
url: "https://eslint.style/rules/js/newline-per-chained-call",
|
|
},
|
|
},
|
|
],
|
|
},
|
|
type: "layout",
|
|
|
|
docs: {
|
|
description: "Require a newline after each call in a method chain",
|
|
recommended: false,
|
|
url: "https://eslint.org/docs/latest/rules/newline-per-chained-call",
|
|
},
|
|
|
|
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;
|
|
|
|
const sourceCode = context.sourceCode;
|
|
|
|
/**
|
|
* 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.
|
|
* @param {ASTNode} node A MemberExpression node to get
|
|
* @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",
|
|
);
|
|
},
|
|
});
|
|
}
|
|
},
|
|
};
|
|
},
|
|
};
|