網站分析程式碼往往有幾十行,直接寫進每個頁面的 HTML 裡,不但雜亂,還會讓 page source 變得擁擠。更好的作法是把它抽成外部資源,由一組共用的通用腳本在執行期動態掛載進來。
將統計程式碼存到一個獨立檔案,例如 /config/counter.conf,內容如下:
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-18744406-1']);
_gaq.push(['_trackPageview']);
(function () {
var ga = document.createElement('script');
ga.type = 'text/javascript';
ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'https://www')
+ '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
})();
</script>
這段碼本身已經採非同步寫法:動態建立 script 元素並插到頁面第一個 script 之前,因此不會阻擋後續資源載入。
以 /do.ashx?args=GetCounter 作為輸出端點,用 StreamReader 讀出檔案內容,稍作轉義後以 document.write 形式回應:
string code = "讀取到的統計代碼";
code = Regex.Replace(code, "['\"]", "\"");
code = Regex.Replace(code, "[\n\r]", "");
context.Response.Write("document.write('" + code + "');");
兩個 Regex 的作用是把單引號統一替換成雙引號,並移除換行與迴車,避免字串被中斷而產生語法錯誤。
最後,在網站都會引用的通用 JavaScript 檔中加入:
var _s = document.createElement('script');
_s.type = 'text/javascript';
_s.src = '/do.ashx?args=GetCounter';
var _fs = document.getElementsByTagName("script")[0];
_fs.parentNode.insertBefore(_s, _fs);
大功告成。統計程式碼不會出現在頁面的原始碼裡,但實際上已經被載入並執行。
除了讓原始碼乾淨,這個間接層還有其他好處:可以依環境、帳號或使用者權限決定要不要輸出統計碼;可以集中管理多個站點的追蹤 ID,不必逐頁修改;也可以在正式環境才啟用、開發環境關閉。
不過要留意兩點。第一,用 document.write 輸出腳本內容屬於舊式做法,在 async/defer 情境下可能清空文件,現代實作應改用 insertBefore 或appendChild 掛載節點,並由端點直接回傳 JavaScript 而非包一層 document.write。第二,把程式碼藏在外部端點雖可減少頁面負擔,卻也讓除錯變得更間接,團隊協作時務必留下清楚的註釋與說明文件。