萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

異步動態加載 JavaScript:標準模塊動態導入、Script 標籤注入、預加載、錯誤處理與依賴管理

按需加載 JS 可顯著提升首屏速度。本文對比 ES Modules 動態 import()、傳統 script 標籤注入、modulepreload 預加載、importmap 依賴映射,並封裝通用 loadScript 工具支援緩存、超時、重試、去重、CSS 同步加載。

現代標準:動態 import()

// 返回 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);

通用 Script 注入工具(支援非模塊腳本、舊瀏覽器)

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);
  }
}
copyright © 萬盛學電腦網 all rights reserved