多支腳本同時載入時,最常見的災情就是全域變數撞名。以下用兩個檔案逐步示範四種改善手法。
a.js 與 b.js 都宣告了全域變數 a,而全域變數屬於 window,後者會直接覆蓋前者。
//a.js <script type="text/javascript"> var a = 123, b = "hello world"; </script>
//b.js <script type="text/javascript"> var a, c = "abc"; </script>
//a.js
(function()
{
var a = 123, b = "hello world";
})();
//b.js
(function()
{
var a, c = "abc";
})();
此時 a.js 與 b.js 裡的 a 都不是全域變數了,衝突問題解決。但新的問題出現:b.js 完全無法讀到 a.js 裡的 b,兩個模組之間沒有任何溝通管道。
var str;
//a.js
(function()
{
var a = 123, b = "hello world";
window.str = a;
})();
//b.js
(function()
{
var a, c = "abc";
alert(window.str);
})();
把 window.str 當成兩邊的傳遞通道,溝通問題解決了。但這種做法等於把全域變數又請回來,而且數量會越來越多、越來越難追蹤——本質上只是把問題往後延。
var GLOBAL = {};
//a.js
(function()
{
var a = 123, b = "hello world";
GLOBAL.A = GLOBAL.A || {};
GLOBAL.A.a = a;
})();
//b.js
(function()
{
var a, c = "abc";
alert(GLOBAL.A.a);
})();
只往全域掛一個 GLOBAL 物件,其餘的一切都收在它底下分層管理。全域命名空間依然乾淨,模組之間也能自由通訊,這是長時間以來前端的主流解法(Dojo、YUI、早期 jQuery 的 jQuery.fn 都是這個思路)。
這裡我加了一行 GLOBAL.A = GLOBAL.A || {};:如果 a.js 與 b.js 都需要往 GLOBAL.A 底下寫東西,不先做這層確保,載入順序一換就會出現「無法在 undefined 上設定屬性」的錯誤。
命名空間雖然解決了衝突,仍有兩個惱人之處:一是層級寫得深了很囉嗦(GLOBAL.A.B.C.doSomething()),二是各模組間的依賴關係不明顯,得靠人肉記憶。
今日的正解是模組系統。import/export 讓每個檔案自動擁有獨立作用域,依賴關係寫在檔案頂端一目了然,打包工具(webpack、Vite 等)還能做 tree shaking 與名稱最佳化,連全域變數都不需要:
// a.js
export const a = 123;
export const b = "hello world";
// b.js
import { a } from './a.js';
console.log(a);
若必須在無模組環境(例如直接引入的舊式 script 標籤)中實作,上面的 IIFE 加命名空間仍是目前最穩妥的選擇。