按需加載 JS 可顯著提升首屏速度。本文對比 ES Modules 動態 import()、傳統 script 標籤注入、modulepreload 預加載、importmap 依賴映射,並封裝通用 loadScript 工具支援緩存、超時、重試、去重、CSS 同步加載。
// 返回 Promise,支援 Tree-shaking、TypeScript 類型推斷
async function loadModule(url) {
try {
const module = await import(url);
return module.default || module;
} catch (err) {
console.error(`模塊加載失敗: ${url}`, err);
throw err;
}
}
// 使用
const { default: Chart } = await loadModule('/charts/chart.js');
Chart.render('#container', data);
const scriptCache = new Map();
function loadScript(src, options = {}) {
const {
attrs = {},
timeout = 10000,
retries = 0,
beforeLoad,
onLoad,
onError
} = options;
// 去重:同一 src 僅加載一次
if (scriptCache.has(src)) {
return scriptCache.get(src);
}
const promise = new Promise((resolve, reject) => {
const script = document.createElement('script');
script.src = src;
script.async = true; // 異步加載,不阻塞解析
Object.entries(attrs).forEach(([k, v]) => script.setAttribute(k, v));
const timer = setTimeout(() => {
cleanup();
reject(new Error(`Load timeout: ${src}`));
}, timeout);
function cleanup() {
clearTimeout(timer);
script.onload = script.onerror = null;
}
script.onload = () => {
cleanup();
onLoad?.(script);
resolve(script);
};
script.onerror = (err) => {
cleanup();
onError?.(err);
if (retries > 0) {
loadScript(src, { ...options, retries: retries - 1 }).then(resolve, reject);
} else {
reject(err);
}
};
beforeLoad?.(script);
document.head.appendChild(script);
});
scriptCache.set(src, promise);
return promise;
}
// 同步加載 CSS
function loadStyle(href) {
return new Promise((resolve, reject) => {
const link = document.createElement('link');
link.rel = 'stylesheet';
link.href = href;
link.onload = resolve;
link.onerror = reject;
document.head.appendChild(link);
});
}
// 並行加載 JS + CSS
await Promise.all([
loadScript('/lib/editor.js'),
loadStyle('/lib/editor.css')
]);
<!-- HTML 預加載,瀏覽器高優先級下載,不執行 -->
<link rel="modulepreload" href="/charts/chart.js">
<link rel="preload" as="script" href="/lib/editor.js">
<!-- importmap 依賴映射,裸模塊名導入 -->
<script type="importmap">
{
"imports": {
"vue": "https://unpkg.com/vue@3/dist/vue.esm-browser.js",
"lodash": "https://unpkg.com/lodash@4/lodash.esm.js"
}
}
</script>
importmap 統一版本。externals 或 shared(Module Federation)。window.__MODULES__ = { 'vue': Vue },加載前檢查。async function safeLoad(url, fallbackUrl) {
try { return await loadScript(url); }
catch {
console.warn(`Primary failed, trying fallback: ${fallbackUrl}`);
return loadScript(fallbackUrl);
}
}