Luiz Costa
ac4f232e5e
This change modifies the build scripts to use --legacy-peer-deps flag when installing npm dependencies to resolve potential peer dependency conflicts during the build process. The change is applied to both bash (build.sh) and batch (build.bat) build scripts.
447 lines
15 KiB
JavaScript
447 lines
15 KiB
JavaScript
/**
|
|
* @fileoverview A rule to verify `super()` callings in constructor.
|
|
* @author Toru Nagashima
|
|
*/
|
|
|
|
"use strict";
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Helpers
|
|
//------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Checks all segments in a set and returns true if any are reachable.
|
|
* @param {Set<CodePathSegment>} segments The segments to check.
|
|
* @returns {boolean} True if any segment is reachable; false otherwise.
|
|
*/
|
|
function isAnySegmentReachable(segments) {
|
|
|
|
for (const segment of segments) {
|
|
if (segment.reachable) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Checks whether or not a given node is a constructor.
|
|
* @param {ASTNode} node A node to check. This node type is one of
|
|
* `Program`, `FunctionDeclaration`, `FunctionExpression`, and
|
|
* `ArrowFunctionExpression`.
|
|
* @returns {boolean} `true` if the node is a constructor.
|
|
*/
|
|
function isConstructorFunction(node) {
|
|
return (
|
|
node.type === "FunctionExpression" &&
|
|
node.parent.type === "MethodDefinition" &&
|
|
node.parent.kind === "constructor"
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Checks whether a given node can be a constructor or not.
|
|
* @param {ASTNode} node A node to check.
|
|
* @returns {boolean} `true` if the node can be a constructor.
|
|
*/
|
|
function isPossibleConstructor(node) {
|
|
if (!node) {
|
|
return false;
|
|
}
|
|
|
|
switch (node.type) {
|
|
case "ClassExpression":
|
|
case "FunctionExpression":
|
|
case "ThisExpression":
|
|
case "MemberExpression":
|
|
case "CallExpression":
|
|
case "NewExpression":
|
|
case "ChainExpression":
|
|
case "YieldExpression":
|
|
case "TaggedTemplateExpression":
|
|
case "MetaProperty":
|
|
return true;
|
|
|
|
case "Identifier":
|
|
return node.name !== "undefined";
|
|
|
|
case "AssignmentExpression":
|
|
if (["=", "&&="].includes(node.operator)) {
|
|
return isPossibleConstructor(node.right);
|
|
}
|
|
|
|
if (["||=", "??="].includes(node.operator)) {
|
|
return (
|
|
isPossibleConstructor(node.left) ||
|
|
isPossibleConstructor(node.right)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* All other assignment operators are mathematical assignment operators (arithmetic or bitwise).
|
|
* An assignment expression with a mathematical operator can either evaluate to a primitive value,
|
|
* or throw, depending on the operands. Thus, it cannot evaluate to a constructor function.
|
|
*/
|
|
return false;
|
|
|
|
case "LogicalExpression":
|
|
|
|
/*
|
|
* If the && operator short-circuits, the left side was falsy and therefore not a constructor, and if
|
|
* it doesn't short-circuit, it takes the value from the right side, so the right side must always be a
|
|
* possible constructor. A future improvement could verify that the left side could be truthy by
|
|
* excluding falsy literals.
|
|
*/
|
|
if (node.operator === "&&") {
|
|
return isPossibleConstructor(node.right);
|
|
}
|
|
|
|
return (
|
|
isPossibleConstructor(node.left) ||
|
|
isPossibleConstructor(node.right)
|
|
);
|
|
|
|
case "ConditionalExpression":
|
|
return (
|
|
isPossibleConstructor(node.alternate) ||
|
|
isPossibleConstructor(node.consequent)
|
|
);
|
|
|
|
case "SequenceExpression": {
|
|
const lastExpression = node.expressions[node.expressions.length - 1];
|
|
|
|
return isPossibleConstructor(lastExpression);
|
|
}
|
|
|
|
default:
|
|
return false;
|
|
}
|
|
}
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Rule Definition
|
|
//------------------------------------------------------------------------------
|
|
|
|
/** @type {import('../shared/types').Rule} */
|
|
module.exports = {
|
|
meta: {
|
|
type: "problem",
|
|
|
|
docs: {
|
|
description: "Require `super()` calls in constructors",
|
|
recommended: true,
|
|
url: "https://eslint.org/docs/latest/rules/constructor-super"
|
|
},
|
|
|
|
schema: [],
|
|
|
|
messages: {
|
|
missingSome: "Lacked a call of 'super()' in some code paths.",
|
|
missingAll: "Expected to call 'super()'.",
|
|
|
|
duplicate: "Unexpected duplicate 'super()'.",
|
|
badSuper: "Unexpected 'super()' because 'super' is not a constructor.",
|
|
unexpected: "Unexpected 'super()'."
|
|
}
|
|
},
|
|
|
|
create(context) {
|
|
|
|
/*
|
|
* {{hasExtends: boolean, scope: Scope, codePath: CodePath}[]}
|
|
* Information for each constructor.
|
|
* - upper: Information of the upper constructor.
|
|
* - hasExtends: A flag which shows whether own class has a valid `extends`
|
|
* part.
|
|
* - scope: The scope of own class.
|
|
* - codePath: The code path object of the constructor.
|
|
*/
|
|
let funcInfo = null;
|
|
|
|
/*
|
|
* {Map<string, {calledInSomePaths: boolean, calledInEveryPaths: boolean}>}
|
|
* Information for each code path segment.
|
|
* - calledInSomePaths: A flag of be called `super()` in some code paths.
|
|
* - calledInEveryPaths: A flag of be called `super()` in all code paths.
|
|
* - validNodes:
|
|
*/
|
|
let segInfoMap = Object.create(null);
|
|
|
|
/**
|
|
* Gets the flag which shows `super()` is called in some paths.
|
|
* @param {CodePathSegment} segment A code path segment to get.
|
|
* @returns {boolean} The flag which shows `super()` is called in some paths
|
|
*/
|
|
function isCalledInSomePath(segment) {
|
|
return segment.reachable && segInfoMap[segment.id].calledInSomePaths;
|
|
}
|
|
|
|
/**
|
|
* Gets the flag which shows `super()` is called in all paths.
|
|
* @param {CodePathSegment} segment A code path segment to get.
|
|
* @returns {boolean} The flag which shows `super()` is called in all paths.
|
|
*/
|
|
function isCalledInEveryPath(segment) {
|
|
|
|
/*
|
|
* If specific segment is the looped segment of the current segment,
|
|
* skip the segment.
|
|
* If not skipped, this never becomes true after a loop.
|
|
*/
|
|
if (segment.nextSegments.length === 1 &&
|
|
segment.nextSegments[0].isLoopedPrevSegment(segment)
|
|
) {
|
|
return true;
|
|
}
|
|
return segment.reachable && segInfoMap[segment.id].calledInEveryPaths;
|
|
}
|
|
|
|
return {
|
|
|
|
/**
|
|
* Stacks a constructor information.
|
|
* @param {CodePath} codePath A code path which was started.
|
|
* @param {ASTNode} node The current node.
|
|
* @returns {void}
|
|
*/
|
|
onCodePathStart(codePath, node) {
|
|
if (isConstructorFunction(node)) {
|
|
|
|
// Class > ClassBody > MethodDefinition > FunctionExpression
|
|
const classNode = node.parent.parent.parent;
|
|
const superClass = classNode.superClass;
|
|
|
|
funcInfo = {
|
|
upper: funcInfo,
|
|
isConstructor: true,
|
|
hasExtends: Boolean(superClass),
|
|
superIsConstructor: isPossibleConstructor(superClass),
|
|
codePath,
|
|
currentSegments: new Set()
|
|
};
|
|
} else {
|
|
funcInfo = {
|
|
upper: funcInfo,
|
|
isConstructor: false,
|
|
hasExtends: false,
|
|
superIsConstructor: false,
|
|
codePath,
|
|
currentSegments: new Set()
|
|
};
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Pops a constructor information.
|
|
* And reports if `super()` lacked.
|
|
* @param {CodePath} codePath A code path which was ended.
|
|
* @param {ASTNode} node The current node.
|
|
* @returns {void}
|
|
*/
|
|
onCodePathEnd(codePath, node) {
|
|
const hasExtends = funcInfo.hasExtends;
|
|
|
|
// Pop.
|
|
funcInfo = funcInfo.upper;
|
|
|
|
if (!hasExtends) {
|
|
return;
|
|
}
|
|
|
|
// Reports if `super()` lacked.
|
|
const segments = codePath.returnedSegments;
|
|
const calledInEveryPaths = segments.every(isCalledInEveryPath);
|
|
const calledInSomePaths = segments.some(isCalledInSomePath);
|
|
|
|
if (!calledInEveryPaths) {
|
|
context.report({
|
|
messageId: calledInSomePaths
|
|
? "missingSome"
|
|
: "missingAll",
|
|
node: node.parent
|
|
});
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Initialize information of a given code path segment.
|
|
* @param {CodePathSegment} segment A code path segment to initialize.
|
|
* @returns {void}
|
|
*/
|
|
onCodePathSegmentStart(segment) {
|
|
|
|
funcInfo.currentSegments.add(segment);
|
|
|
|
if (!(funcInfo && funcInfo.isConstructor && funcInfo.hasExtends)) {
|
|
return;
|
|
}
|
|
|
|
// Initialize info.
|
|
const info = segInfoMap[segment.id] = {
|
|
calledInSomePaths: false,
|
|
calledInEveryPaths: false,
|
|
validNodes: []
|
|
};
|
|
|
|
// When there are previous segments, aggregates these.
|
|
const prevSegments = segment.prevSegments;
|
|
|
|
if (prevSegments.length > 0) {
|
|
info.calledInSomePaths = prevSegments.some(isCalledInSomePath);
|
|
info.calledInEveryPaths = prevSegments.every(isCalledInEveryPath);
|
|
}
|
|
},
|
|
|
|
onUnreachableCodePathSegmentStart(segment) {
|
|
funcInfo.currentSegments.add(segment);
|
|
},
|
|
|
|
onUnreachableCodePathSegmentEnd(segment) {
|
|
funcInfo.currentSegments.delete(segment);
|
|
},
|
|
|
|
onCodePathSegmentEnd(segment) {
|
|
funcInfo.currentSegments.delete(segment);
|
|
},
|
|
|
|
|
|
/**
|
|
* Update information of the code path segment when a code path was
|
|
* looped.
|
|
* @param {CodePathSegment} fromSegment The code path segment of the
|
|
* end of a loop.
|
|
* @param {CodePathSegment} toSegment A code path segment of the head
|
|
* of a loop.
|
|
* @returns {void}
|
|
*/
|
|
onCodePathSegmentLoop(fromSegment, toSegment) {
|
|
if (!(funcInfo && funcInfo.isConstructor && funcInfo.hasExtends)) {
|
|
return;
|
|
}
|
|
|
|
// Update information inside of the loop.
|
|
const isRealLoop = toSegment.prevSegments.length >= 2;
|
|
|
|
funcInfo.codePath.traverseSegments(
|
|
{ first: toSegment, last: fromSegment },
|
|
segment => {
|
|
const info = segInfoMap[segment.id];
|
|
const prevSegments = segment.prevSegments;
|
|
|
|
// Updates flags.
|
|
info.calledInSomePaths = prevSegments.some(isCalledInSomePath);
|
|
info.calledInEveryPaths = prevSegments.every(isCalledInEveryPath);
|
|
|
|
// If flags become true anew, reports the valid nodes.
|
|
if (info.calledInSomePaths || isRealLoop) {
|
|
const nodes = info.validNodes;
|
|
|
|
info.validNodes = [];
|
|
|
|
for (let i = 0; i < nodes.length; ++i) {
|
|
const node = nodes[i];
|
|
|
|
context.report({
|
|
messageId: "duplicate",
|
|
node
|
|
});
|
|
}
|
|
}
|
|
}
|
|
);
|
|
},
|
|
|
|
/**
|
|
* Checks for a call of `super()`.
|
|
* @param {ASTNode} node A CallExpression node to check.
|
|
* @returns {void}
|
|
*/
|
|
"CallExpression:exit"(node) {
|
|
if (!(funcInfo && funcInfo.isConstructor)) {
|
|
return;
|
|
}
|
|
|
|
// Skips except `super()`.
|
|
if (node.callee.type !== "Super") {
|
|
return;
|
|
}
|
|
|
|
// Reports if needed.
|
|
if (funcInfo.hasExtends) {
|
|
const segments = funcInfo.currentSegments;
|
|
let duplicate = false;
|
|
let info = null;
|
|
|
|
for (const segment of segments) {
|
|
|
|
if (segment.reachable) {
|
|
info = segInfoMap[segment.id];
|
|
|
|
duplicate = duplicate || info.calledInSomePaths;
|
|
info.calledInSomePaths = info.calledInEveryPaths = true;
|
|
}
|
|
}
|
|
|
|
if (info) {
|
|
if (duplicate) {
|
|
context.report({
|
|
messageId: "duplicate",
|
|
node
|
|
});
|
|
} else if (!funcInfo.superIsConstructor) {
|
|
context.report({
|
|
messageId: "badSuper",
|
|
node
|
|
});
|
|
} else {
|
|
info.validNodes.push(node);
|
|
}
|
|
}
|
|
} else if (isAnySegmentReachable(funcInfo.currentSegments)) {
|
|
context.report({
|
|
messageId: "unexpected",
|
|
node
|
|
});
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Set the mark to the returned path as `super()` was called.
|
|
* @param {ASTNode} node A ReturnStatement node to check.
|
|
* @returns {void}
|
|
*/
|
|
ReturnStatement(node) {
|
|
if (!(funcInfo && funcInfo.isConstructor && funcInfo.hasExtends)) {
|
|
return;
|
|
}
|
|
|
|
// Skips if no argument.
|
|
if (!node.argument) {
|
|
return;
|
|
}
|
|
|
|
// Returning argument is a substitute of 'super()'.
|
|
const segments = funcInfo.currentSegments;
|
|
|
|
for (const segment of segments) {
|
|
|
|
if (segment.reachable) {
|
|
const info = segInfoMap[segment.id];
|
|
|
|
info.calledInSomePaths = info.calledInEveryPaths = true;
|
|
}
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Resets state.
|
|
* @returns {void}
|
|
*/
|
|
"Program:exit"() {
|
|
segInfoMap = Object.create(null);
|
|
}
|
|
};
|
|
}
|
|
};
|