跳转到内容

性能中的概念

用动态 import() 做代码拆分

发布于 更新于

代码拆分把 JavaScript 包分成多个文件,让浏览器启动时只下载当前路由需要的代码,再解析并执行。其余代码用 import() 按需加载;这个表达式返回 Promise,兑现值是模块命名空间对象。在 PWA 里它能缩短首次交互前的等待,而且每个分块都是独立文件,Service Worker 可以逐块缓存和更新。

静态 import 声明会提升,在导入方模块运行任何代码之前求值,所以入口模块的每个静态依赖都在启动图里。import(specifier) 是表达式:配置了拆分的打包器会把目标模块输出为单独文件,浏览器在表达式执行时抓取它,Promise 以该模块的导出兑现(javascript.operators.import:Chrome 63、Firefox 67、Safari 11.1)。模块完成加载和链接后只求值一次,按解析后的 URL 缓存。再次调用 import() 会返回同一个命名空间,不再请求网络。失败时只有求值失败会被缓存,加载或链接失败后再次调用可能重试,抓取仍受 HTTP 缓存规则约束(import(),developer.mozilla.org)。

  • 按路由拆分,让每个路由的视图独立成块,匹配到路由时再加载。这是应用型 PWA 里常见的第一刀,框架路由器通过懒加载组件提供同样的做法。
  • 编辑器和图表等重型组件留到首次交互时加载,地图也一样;加载期间先渲染轻量的占位内容。
  • 把第三方依赖单独打包。它们比应用代码变动少,部署时如果只改了应用代码,第三方分块仍可使用原有缓存。

按需加载会增加使用时的等待。点击后才请求分块,通常要等一次网络往返,除非 Service Worker 已预缓存它、HTTP 缓存里有它,或页面已用 <link rel="modulepreload"> 加载它。启动工作完成后提前取回可能用到的分块,可以掩盖这段等待,又不增加启动负担。

import() 在窗口、专用 worker 和共享 worker 中可用,在 Service Worker 和 worklet 中返回的 Promise 会以 TypeError 拒绝(HTML Standard)。需要可选代码的 Service Worker 可以把它打包进去,或者用 importScripts() 加载;后者是同步的,按 Service Worker 规范只在 worker 处于 parsed 或 installing 状态时(初次求值和 install 事件期间)才会抓取新脚本。

动态 import() 自 Chrome 63、Firefox 67、Safari 11.1 和 Edge 79 起存在于所有引擎(BCD javascript.operators.import),webpack、Rollup、Parcel 等打包器把它当作拆分点。esbuild 要打开 splitting 选项并输出 ESM 才会拆。缺口是 Service Worker 和 worklet,HTML Standard 在这两处会拒绝它。

路由模块和可选组件都可以用 import() 按需加载。

路由器把路径映射到动态导入。分块在首次导航到该路由时抓取,之后来自模块缓存。

const routes = {
'/': () => import('./views/home.js'),
'/settings': () => import('./views/settings.js'),
'/editor': () => import('./views/editor.js'),
};
async function navigate(path) {
const load = routes[path] ?? routes['/'];
const view = await load();
view.render(document.querySelector('#app'));
}

提前调用下一个可能路由的加载函数(例如用户悬停在「编辑」按钮上时执行 routes['/editor']()),会在点击前抓取并求值那个分块,往返被藏起来,分块也不进启动。

图表库只在用户点击按钮时加载,catch 让离线失败不至于弄坏页面。

button.addEventListener('click', async () => {
button.disabled = true;
try {
const { renderChart } = await import('./chart.js');
renderChart(document.querySelector('#chart'), data);
} catch (err) {
showMessage('图表无法加载。请检查网络连接后重试。');
button.disabled = false;
}
});

加载失败后再点一次,可能会重新抓取这个分块,因为加载失败不会像求值失败那样被保留;HTTP 缓存仍然生效。

检测动态 import 并保留打包的兜底

链接到“检测动态 import 并保留打包的兜底”一节

没有 import() 的引擎比「支持位置」一节列出的更老,但必须服务它们的构建可以给它们发单一的打包文件。代码把每个 import() 都包进 new Function(),这样不认识该语法的解析器不会拒绝整个脚本(需要 CSP 允许 unsafe-eval)。

function supportsDynamicImport() {
if (!('noModule' in HTMLScriptElement.prototype)) {
return false; // 完全没有模块脚本:也没有 import()
}
try {
new Function('return import("data:text/javascript,")');
return true;
} catch {
return false; // 有模块但没有 import():改为加载单一的旧版包
}
}
if (supportsDynamicImport()) {
new Function('return import("/app.modern.js")')();
} else {
const script = document.createElement('script');
script.src = '/app.legacy.js';
document.head.append(script);
}

noModule 检查在解析探测之前排除了比模块脚本更老的引擎;探测只构造函数、从不执行,所以不会发出请求。

规范

规范状态
无。