TreeShaking 与 SideEffect

Rollup 有很强大的程序流分析,从而可以大量移除冗余的、未被引用的代码,但是一些情况下 Rollup 为了保守起见,依然会保留这些代码,这些情况包括:

  1. import 的模块可能存在 side effect
  2. 引用的对象可能存在 side effect

参考以下的 FAQ tree-shaking-doesnt-seem-to-be-working

Example

最近我在实际的业务中就遇到了类似的情况,例如有 module-a.jsmodule-b.js 模块:

javascript 复制代码
// module-b.js
var EnumType
(function (EnumType) {
	EnumType['A'] = 'A';
})(EnumType)

export {
	EnumType
}
javascript 复制代码
// module-a.js
import { EnumType } from './module-b'

const dumbObjA = {
  type: EnumType.A
}

const dumbObjB = {
  type: 'B',
}

export function print() {
	console.log('hello')
}
javascript 复制代码
// main.js
import { print } from './module-a'

print()

表面上看 dumbObjAdumbObjB 都没有被引用,我们会期望 Rollup 打包之后的代码里 dumbObjAdumbObjB 都会被移除掉,但实际结果却是只有 dumbObjB 被清理掉,而 dumbObjA 以及 EnumType 都被保留了,这有些出乎意料:

javascript 复制代码
// Rollup 打包后的代码 index-XXX.js
var EnumType = /* @__PURE__ */ ((EnumType2) => {
  EnumType2["A"] = "A";
  return EnumType2;
})(EnumType || {});
({
  type: EnumType.A
});
function print() {
  console.log("hello");
}
print();

这正是上文所提及的:

引用的对象可能存在 side effect

由于 dumbObjA 的创建访问了 EnumType.A,Rollup 认为 EnumType.A 可能存在 side effect,因为 EnumType 是通过一个 IIFE(立即执行的函数表达式)创建的, EnumType.A 的访问可能触发 getter 从而执行一些 side effect 函数,为了保守起见,Rollup 保留的 dumbObjA 的代码。

作为开发者我们当然可以清楚地分辨出 EnumType.A 并没有 getter,可是 Rollup 并不如人聪明它无法分辨,因而为了保守起见它只能够保留这些可能有 side effect 的代码。

如果我们对 module-b.js 做一些修改,Rollup 才能够正确分辨出 EnumType 是没有 getter 的,可以放心清除掉它。

javascript 复制代码
// module-b.js
var EnumType = {
	A: 'A'
}

export {
	EnumType
}
javascript 复制代码
// Rollup 打包后的代码 index-XXX.js
function print() {
  console.log("hello");
}
print();

Why create EnumType using IIFE?

或许你会感到奇怪,如果一开始就不使用 IIFE 来创建 EnumType 的话,问题就不会存在。确实如此,但如果你使用的是 TS,而且不巧你用上了 TS 的 enum 关键字的话,那么最终 EnumType 就无可避免地被编译为 IIFE。至于为什么 TS 的 enum 为什么要编译成 IIFE,原因之一是 enum 支持声明合并的特性,这里也有些相关的讨论

typescript 复制代码
// module-b.ts
enum EnumType {
  A = 'A'
}

// 编译为 module-b.js
var EnumType
(function (EnumType) {
	EnumType['A'] = 'A';
})(EnumType)

export {
	EnumType
}

总结

长话短说,如果你是 TS 的开发者,而且你需要 TreeShaking 能够工作的话,考虑放弃 TS 的 enum 的使用。

References

相关推荐
人工智能训练师4 小时前
Ubuntu22.04如何安装新版本的Node.js和npm
linux·运维·前端·人工智能·ubuntu·npm·node.js
Seveny074 小时前
pnpm相对于npm,yarn的优势
前端·npm·node.js
yddddddy5 小时前
css的基本知识
前端·css
昔人'5 小时前
css `lh`单位
前端·css
前端君5 小时前
实现最大异步并发执行队列
javascript
Nan_Shu_6146 小时前
Web前端面试题(2)
前端
知识分享小能手7 小时前
React学习教程,从入门到精通,React 组件核心语法知识点详解(类组件体系)(19)
前端·javascript·vue.js·学习·react.js·react·anti-design-vue
蚂蚁RichLab前端团队7 小时前
🚀🚀🚀 RichLab - 花呗前端团队招贤纳士 - 【转岗/内推/社招】
前端·javascript·人工智能
孩子 你要相信光8 小时前
css之一个元素可以同时应用多个动画效果
前端·css
萌萌哒草头将军8 小时前
Oxc 和 Rolldown Q4 更新计划速览!🚀🚀🚀
javascript·vue.js·vite