在現代 Web 開發中,動態載入 JavaScript 檔案是常見需求,例如按需載入、延遲載入或根據條件載入不同腳本。jQuery 提供了簡潔的 API 讓這項工作變得輕鬆。本文整理三種主流做法,並附上完整程式碼範例,方便直接套用專案中。
$.getScript() —— 最簡單的一行搞定jQuery 內建的 $.getScript() 專為載入並執行 JS 檔案而設計,支援快取控制與回呼函式,是首選方案。
// 基本用法
$.getScript("test.js", function() {
// 載入完成後的回呼
console.log("test.js 已載入並執行");
});
// 進階:關閉快取(避免瀏覽器讀取舊版本)
$.ajaxSetup({ cache: false });
$.getScript("test.js");
優點:程式碼極少、自動處理載入順序、支援跨域(需伺服器端設定 CORS)。
缺點:預設開啟快取,若需每次重新載入須額外設定。
<script> 標籤並插入 <head>若需更精細控制(如指定 ID、移除舊腳本、設定屬性),可手動操作 DOM。
function loadJS(file) {
// 移除同 ID 的舊標籤,避免重複
$('#loadscript').remove();
// 建立新 script 標籤並設定屬性
$('').attr({
src: file,
type: 'text/javascript',
id: 'loadscript'
}).appendTo('head');
}
// 使用範例
loadJS('plugin.js');
關鍵細節:
$('#loadscript').remove() 確保同一檔案不會重複插入appendTo('head') 比 appendTo('body') 更符合規範,且不影響頁面渲染將上述邏輯濃縮為單行,適合臨時在 Console 測試或極簡專案:
$('').attr({src: file, type: 'text/javascript', id: 'load'}).appendTo($('#loadscript').remove().end().parent());
解析:$('#loadscript').remove().end() 先移除舊元素再回到原 jQuery 物件,最後 .parent() 取得 <head> 進行插入。
Promise/async-await 管理。$.getScript() 失敗不會拋出例外,建議搭配 .fail() 捕捉:$.getScript("x.js").fail(() => console.error("載入失敗"));script-src 加入 'unsafe-inline' 或使用 nonce/hash 才能執行動態腳本。| 方法 | 適用場景 | 程式碼量 | 可維護性 |
|---|---|---|---|
| $.getScript() | 一般專案、需回呼處理 | 極少 | ★★★★★ |
| 手動建立 script | 需控制 ID、屬性、移除舊檔 | 中等 | ★★★★☆ |
| 一行式壓縮 | 除錯、臨時測試、Code Golf | 最少 | ★☆☆☆☆ |
根據專案需求挑選最合適的方式,並記得在正式環境做好快取策略與錯誤監控,即可穩定實現 JS 動態載入。