123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497 |
- /*
- MIT License http://www.opensource.org/licenses/mit-license.php
- Author Tobias Koppers @sokra
- */
- "use strict";
- const CachedConstDependency = require("./dependencies/CachedConstDependency");
- const ConstDependency = require("./dependencies/ConstDependency");
- const { evaluateToString } = require("./javascript/JavascriptParserHelpers");
- const { parseResource } = require("./util/identifier");
- /** @typedef {import("estree").Expression} ExpressionNode */
- /** @typedef {import("estree").Super} SuperNode */
- /** @typedef {import("./Compiler")} Compiler */
- const collectDeclaration = (declarations, pattern) => {
- const stack = [pattern];
- while (stack.length > 0) {
- const node = stack.pop();
- switch (node.type) {
- case "Identifier":
- declarations.add(node.name);
- break;
- case "ArrayPattern":
- for (const element of node.elements) {
- if (element) {
- stack.push(element);
- }
- }
- break;
- case "AssignmentPattern":
- stack.push(node.left);
- break;
- case "ObjectPattern":
- for (const property of node.properties) {
- stack.push(property.value);
- }
- break;
- case "RestElement":
- stack.push(node.argument);
- break;
- }
- }
- };
- const getHoistedDeclarations = (branch, includeFunctionDeclarations) => {
- const declarations = new Set();
- const stack = [branch];
- while (stack.length > 0) {
- const node = stack.pop();
- // Some node could be `null` or `undefined`.
- if (!node) continue;
- switch (node.type) {
- // Walk through control statements to look for hoisted declarations.
- // Some branches are skipped since they do not allow declarations.
- case "BlockStatement":
- for (const stmt of node.body) {
- stack.push(stmt);
- }
- break;
- case "IfStatement":
- stack.push(node.consequent);
- stack.push(node.alternate);
- break;
- case "ForStatement":
- stack.push(node.init);
- stack.push(node.body);
- break;
- case "ForInStatement":
- case "ForOfStatement":
- stack.push(node.left);
- stack.push(node.body);
- break;
- case "DoWhileStatement":
- case "WhileStatement":
- case "LabeledStatement":
- stack.push(node.body);
- break;
- case "SwitchStatement":
- for (const cs of node.cases) {
- for (const consequent of cs.consequent) {
- stack.push(consequent);
- }
- }
- break;
- case "TryStatement":
- stack.push(node.block);
- if (node.handler) {
- stack.push(node.handler.body);
- }
- stack.push(node.finalizer);
- break;
- case "FunctionDeclaration":
- if (includeFunctionDeclarations) {
- collectDeclaration(declarations, node.id);
- }
- break;
- case "VariableDeclaration":
- if (node.kind === "var") {
- for (const decl of node.declarations) {
- collectDeclaration(declarations, decl.id);
- }
- }
- break;
- }
- }
- return Array.from(declarations);
- };
- class ConstPlugin {
- /**
- * Apply the plugin
- * @param {Compiler} compiler the compiler instance
- * @returns {void}
- */
- apply(compiler) {
- const cachedParseResource = parseResource.bindCache(compiler.root);
- compiler.hooks.compilation.tap(
- "ConstPlugin",
- (compilation, { normalModuleFactory }) => {
- compilation.dependencyTemplates.set(
- ConstDependency,
- new ConstDependency.Template()
- );
- compilation.dependencyTemplates.set(
- CachedConstDependency,
- new CachedConstDependency.Template()
- );
- const handler = parser => {
- parser.hooks.statementIf.tap("ConstPlugin", statement => {
- if (parser.scope.isAsmJs) return;
- const param = parser.evaluateExpression(statement.test);
- const bool = param.asBool();
- if (typeof bool === "boolean") {
- if (!param.couldHaveSideEffects()) {
- const dep = new ConstDependency(`${bool}`, param.range);
- dep.loc = statement.loc;
- parser.state.module.addPresentationalDependency(dep);
- } else {
- parser.walkExpression(statement.test);
- }
- const branchToRemove = bool
- ? statement.alternate
- : statement.consequent;
- if (branchToRemove) {
- // Before removing the dead branch, the hoisted declarations
- // must be collected.
- //
- // Given the following code:
- //
- // if (true) f() else g()
- // if (false) {
- // function f() {}
- // const g = function g() {}
- // if (someTest) {
- // let a = 1
- // var x, {y, z} = obj
- // }
- // } else {
- // …
- // }
- //
- // the generated code is:
- //
- // if (true) f() else {}
- // if (false) {
- // var f, x, y, z; (in loose mode)
- // var x, y, z; (in strict mode)
- // } else {
- // …
- // }
- //
- // NOTE: When code runs in strict mode, `var` declarations
- // are hoisted but `function` declarations don't.
- //
- let declarations;
- if (parser.scope.isStrict) {
- // If the code runs in strict mode, variable declarations
- // using `var` must be hoisted.
- declarations = getHoistedDeclarations(branchToRemove, false);
- } else {
- // Otherwise, collect all hoisted declaration.
- declarations = getHoistedDeclarations(branchToRemove, true);
- }
- let replacement;
- if (declarations.length > 0) {
- replacement = `{ var ${declarations.join(", ")}; }`;
- } else {
- replacement = "{}";
- }
- const dep = new ConstDependency(
- replacement,
- branchToRemove.range
- );
- dep.loc = branchToRemove.loc;
- parser.state.module.addPresentationalDependency(dep);
- }
- return bool;
- }
- });
- parser.hooks.expressionConditionalOperator.tap(
- "ConstPlugin",
- expression => {
- if (parser.scope.isAsmJs) return;
- const param = parser.evaluateExpression(expression.test);
- const bool = param.asBool();
- if (typeof bool === "boolean") {
- if (!param.couldHaveSideEffects()) {
- const dep = new ConstDependency(` ${bool}`, param.range);
- dep.loc = expression.loc;
- parser.state.module.addPresentationalDependency(dep);
- } else {
- parser.walkExpression(expression.test);
- }
- // Expressions do not hoist.
- // It is safe to remove the dead branch.
- //
- // Given the following code:
- //
- // false ? someExpression() : otherExpression();
- //
- // the generated code is:
- //
- // false ? 0 : otherExpression();
- //
- const branchToRemove = bool
- ? expression.alternate
- : expression.consequent;
- const dep = new ConstDependency("0", branchToRemove.range);
- dep.loc = branchToRemove.loc;
- parser.state.module.addPresentationalDependency(dep);
- return bool;
- }
- }
- );
- parser.hooks.expressionLogicalOperator.tap(
- "ConstPlugin",
- expression => {
- if (parser.scope.isAsmJs) return;
- if (
- expression.operator === "&&" ||
- expression.operator === "||"
- ) {
- const param = parser.evaluateExpression(expression.left);
- const bool = param.asBool();
- if (typeof bool === "boolean") {
- // Expressions do not hoist.
- // It is safe to remove the dead branch.
- //
- // ------------------------------------------
- //
- // Given the following code:
- //
- // falsyExpression() && someExpression();
- //
- // the generated code is:
- //
- // falsyExpression() && false;
- //
- // ------------------------------------------
- //
- // Given the following code:
- //
- // truthyExpression() && someExpression();
- //
- // the generated code is:
- //
- // true && someExpression();
- //
- // ------------------------------------------
- //
- // Given the following code:
- //
- // truthyExpression() || someExpression();
- //
- // the generated code is:
- //
- // truthyExpression() || false;
- //
- // ------------------------------------------
- //
- // Given the following code:
- //
- // falsyExpression() || someExpression();
- //
- // the generated code is:
- //
- // false && someExpression();
- //
- const keepRight =
- (expression.operator === "&&" && bool) ||
- (expression.operator === "||" && !bool);
- if (
- !param.couldHaveSideEffects() &&
- (param.isBoolean() || keepRight)
- ) {
- // for case like
- //
- // return'development'===process.env.NODE_ENV&&'foo'
- //
- // we need a space before the bool to prevent result like
- //
- // returnfalse&&'foo'
- //
- const dep = new ConstDependency(` ${bool}`, param.range);
- dep.loc = expression.loc;
- parser.state.module.addPresentationalDependency(dep);
- } else {
- parser.walkExpression(expression.left);
- }
- if (!keepRight) {
- const dep = new ConstDependency(
- "0",
- expression.right.range
- );
- dep.loc = expression.loc;
- parser.state.module.addPresentationalDependency(dep);
- }
- return keepRight;
- }
- } else if (expression.operator === "??") {
- const param = parser.evaluateExpression(expression.left);
- const keepRight = param.asNullish();
- if (typeof keepRight === "boolean") {
- // ------------------------------------------
- //
- // Given the following code:
- //
- // nonNullish ?? someExpression();
- //
- // the generated code is:
- //
- // nonNullish ?? 0;
- //
- // ------------------------------------------
- //
- // Given the following code:
- //
- // nullish ?? someExpression();
- //
- // the generated code is:
- //
- // null ?? someExpression();
- //
- if (!param.couldHaveSideEffects() && keepRight) {
- // cspell:word returnnull
- // for case like
- //
- // return('development'===process.env.NODE_ENV&&null)??'foo'
- //
- // we need a space before the bool to prevent result like
- //
- // returnnull??'foo'
- //
- const dep = new ConstDependency(" null", param.range);
- dep.loc = expression.loc;
- parser.state.module.addPresentationalDependency(dep);
- } else {
- const dep = new ConstDependency(
- "0",
- expression.right.range
- );
- dep.loc = expression.loc;
- parser.state.module.addPresentationalDependency(dep);
- parser.walkExpression(expression.left);
- }
- return keepRight;
- }
- }
- }
- );
- parser.hooks.optionalChaining.tap("ConstPlugin", expr => {
- /** @type {ExpressionNode[]} */
- const optionalExpressionsStack = [];
- /** @type {ExpressionNode|SuperNode} */
- let next = expr.expression;
- while (
- next.type === "MemberExpression" ||
- next.type === "CallExpression"
- ) {
- if (next.type === "MemberExpression") {
- if (next.optional) {
- // SuperNode can not be optional
- optionalExpressionsStack.push(
- /** @type {ExpressionNode} */ (next.object)
- );
- }
- next = next.object;
- } else {
- if (next.optional) {
- // SuperNode can not be optional
- optionalExpressionsStack.push(
- /** @type {ExpressionNode} */ (next.callee)
- );
- }
- next = next.callee;
- }
- }
- while (optionalExpressionsStack.length) {
- const expression = optionalExpressionsStack.pop();
- const evaluated = parser.evaluateExpression(expression);
- if (evaluated.asNullish()) {
- // ------------------------------------------
- //
- // Given the following code:
- //
- // nullishMemberChain?.a.b();
- //
- // the generated code is:
- //
- // undefined;
- //
- // ------------------------------------------
- //
- const dep = new ConstDependency(" undefined", expr.range);
- dep.loc = expr.loc;
- parser.state.module.addPresentationalDependency(dep);
- return true;
- }
- }
- });
- parser.hooks.evaluateIdentifier
- .for("__resourceQuery")
- .tap("ConstPlugin", expr => {
- if (parser.scope.isAsmJs) return;
- if (!parser.state.module) return;
- return evaluateToString(
- cachedParseResource(parser.state.module.resource).query
- )(expr);
- });
- parser.hooks.expression
- .for("__resourceQuery")
- .tap("ConstPlugin", expr => {
- if (parser.scope.isAsmJs) return;
- if (!parser.state.module) return;
- const dep = new CachedConstDependency(
- JSON.stringify(
- cachedParseResource(parser.state.module.resource).query
- ),
- expr.range,
- "__resourceQuery"
- );
- dep.loc = expr.loc;
- parser.state.module.addPresentationalDependency(dep);
- return true;
- });
- parser.hooks.evaluateIdentifier
- .for("__resourceFragment")
- .tap("ConstPlugin", expr => {
- if (parser.scope.isAsmJs) return;
- if (!parser.state.module) return;
- return evaluateToString(
- cachedParseResource(parser.state.module.resource).fragment
- )(expr);
- });
- parser.hooks.expression
- .for("__resourceFragment")
- .tap("ConstPlugin", expr => {
- if (parser.scope.isAsmJs) return;
- if (!parser.state.module) return;
- const dep = new CachedConstDependency(
- JSON.stringify(
- cachedParseResource(parser.state.module.resource).fragment
- ),
- expr.range,
- "__resourceFragment"
- );
- dep.loc = expr.loc;
- parser.state.module.addPresentationalDependency(dep);
- return true;
- });
- };
- normalModuleFactory.hooks.parser
- .for("javascript/auto")
- .tap("ConstPlugin", handler);
- normalModuleFactory.hooks.parser
- .for("javascript/dynamic")
- .tap("ConstPlugin", handler);
- normalModuleFactory.hooks.parser
- .for("javascript/esm")
- .tap("ConstPlugin", handler);
- }
- );
- }
- }
- module.exports = ConstPlugin;
|