在開發中,我們偶爾需要替引入的外部 JS 檔傳入一些參數。看似簡單,實則有許多種做法,各有取捨。本文系統性地梳理了幾種常見方案。
這是最直截了當的方式,Google AdSense 就是典型例子:
<script type="text/javascript">
google_ad_client = 'pub-3741595817388494';
</script>
<script type="text/javascript" src="https://pagead2.googlesyndication.com/pagead/show_ads.js"></script>
缺點是引入了全域變量。引入檔案本身還有兩個常見變體:
// 變體一:用 document.write 輸出
<script type="text/javascript">
google_ga_id = 'g6u7un8646xx';
document.write(unescape('%3Cscript type="text/javascript" src="https://www.google-analytics.com/ga.js"%3E%3C/script%3E'));
</script>
// 變體二:用 DOM 操作 append 到 head
<script type="text/javascript">
G_BEACON_ATP = 'category=&userid=&channel=112ad_id=';
document.getElementsByTagName('head')[0]
.appendChild(document.createElement('script')).src='https://taobao.com/atp.js';
</script>
其中變體一應用廣泛,常見寫法還有字串拼接以避免標籤提前閉合:
document.write('<scr' + 'ipt type="text/javascript" src="test.js"></scr' + 'ipt>');
相較於全域變量,我們更希望能像這樣傳參:
<script type="text/javascript" src="test.js?a=b&c=d"></script>
核心問題是如何取得該 script 的 src。常見有幾種做法:
方法一:為 script 加上 id,透過 id 找到元素,再用正則從 src 中取出參數。
方法二:以 JS 檔名作為鉤子,透過 document.getElementsByTagName('script') 正則比對出當前檔。正統但要求檔名唯一,程式碼較繁瑣。
方法三:在方法一的基礎上,乾脆自訂一個 data 屬性:
<script id="testScript" type="text/javascript" src="test.js" data="a=b&c=d"></script>
// test.js 內部
var scriptArgs = document.getElementById('testScript').getAttribute('data');
方法四:利用 JS 依文檔流順序執行的特性,當前執行的檔案一定是「已載入」的最後一個:
var scripts = document.getElementsByTagName('script');
var currentScript = scripts[scripts.length - 1];
就程式碼精簡度與效能而言,大致排序為:方法三 > 方法一 > 方法四 > 方法二。
受 John Resig《Degrading Script Tags》啟發,還可以更「任性」一些:
<script type="text/javascript" src="test.js">
TB.SomeApp.scriptArgs = 'a=b&c=d';
</script>
// test.js 內部
TB = {}; TB.SomeApp = {};
var scripts = document.getElementsByTagName("script");
eval(scripts[scripts.length - 1].innerHTML);
參數不多時甚至可以直接寫在標籤內容裡,再利用 onload 屬性傳參,並針對舊版 IE 額外做相容處理。
究竟哪個方案最好?答案是:沒有最好,只有最合適。對「好」的定義會因應用場景與開發理念而異。若不在意嚴格遵循標準、又追求效能,全域變量方案最簡單;若講求規範,則可選方法二或方法四。關鍵是理解每種方案的取捨,依實際需求做出選擇。