编写 javascript tree shaking 回归测试的核心在于验证构建产物中是否真正移除了未使用的代码。具体做法是配置 webpack 或 rollup 等打包工具开启生产模式,引入包含大量无用导出的库文件,然后检查最终输出的 bundle.js 体积和内部符号。如果 tree shaking 生效,未引用的函数不应出现在输出文件中;若未生效,则这些死代码会保留在 bundle 中。通过断言输出文件大小低于阈值或正则匹配确认特定标识符不存在,即可自动化验证该功能。

Webpack 环境下如何验证模块移除
在 Webpack 项目中,Tree Shaking 依赖 ES Module 静态分析和 production 模式。要验证其效果,需创建一个包含多个导出函数的源文件,并在入口文件中仅引用其中一个。运行构建后,检查生成的 dist/main.js 文件内容。如果配置正确,只有被引用的函数会被保留,其他函数及其依赖的代码块应完全消失。可以通过读取构建产物并使用正则表达式搜索未引用的函数名来自动判断测试结果。

// src/utils.js
export function used() { return 'used'; }
export function unused() { return 'unused'; }
// src/index.js
import { used } from './utils';
console.log(used());
// test.js (Node.js script to verify)
const fs = require('fs');
const path = require('path');
const buildOutput = fs.readFileSync(path.join(__dirname, 'dist', 'main.js'), 'utf-8');
if (buildOutput.includes('unused')) {
console.error('FAIL: unused code was not shaken');
} else {
console.log('PASS: tree shaking worked');
}
Rollup 插件机制下的副作用检测
Rollup 通过 sideEffects 字段来判断模块是否有副作用。在回归测试中,需要确保包中的纯函数模块被标记为无副作用,以便 Rollup 安全地丢弃未导入的绑定。测试时,可以在 package.json 中设置 "sideEffects": false 或在 rollup.config.js 中配置 treeshake 选项。构建后,检查输出 bundle 是否只包含被显式导入的模块逻辑。若发现未导入的模块代码残留,说明副作用检测配置有误或模块本身存在隐式副作用。
立即学习“Java免费学习笔记(深入)”;

// rollup.config.js
export default {
input: 'src/index.js',
output: {
file: 'dist/bundle.js',
format: 'es'
},
treeshake: {
moduleSideEffects: false // 假设所有模块都无副作用
}
};
// 验证脚本
const bundle = require('fs').readFileSync('dist/bundle.js', 'utf-8');
// 假设有一个名为 'deadCode' 的函数在源文件中但未在 index.js 中导入
if (bundle.includes('deadCode')) {
throw new Error('Tree shaking failed to remove dead code');
}
如何处理带有副作用的第三方库
当引入的第三方库包含全局副作用(如修改原型链或注册全局事件)时,Tree Shaking 可能会误删看似未使用但实际必要的代码。回归测试需专门针对此类场景设计用例。例如,引入一个虽然只导入部分 API 但初始化时会执行全局注册的库。测试应验证在开启 Tree Shaking 后,这些全局副作用依然被执行,且对应的库代码未被裁剪。通常需要在 package.json 中明确列出有副作用的文件,或在构建配置中使用 external 或 banner 插件来保护关键代码段。


















