日常開發中有些小需求會反覆出現,每次都要重新查。這篇整理四段實用腳本,涵蓋偽陣列轉真陣列、設為首頁、加入收藏,以及偵測瀏覽器是否支援某個屬性。
在 JavaScript 裡,函式中的隱藏變數 arguments 和 getElementsByTagName() 取得的元素集合(NodeList)都不是真正的陣列,沒有 push、map 等方法可用。
對 arguments 來說,Array.prototype.slice.call(arguments) 就能轉換;但 NodeList 在 IE8 及以下會報錯,於是需要做一層相容處理:
function realArray(c) {
try {
return Array.prototype.slice.call(c);
} catch (e) {
var ret = [], i = 0, len = c.length;
for (; i < len; i++) {
ret[i] = c[i];
}
return ret;
}
}
用 try/catch 包住、失敗就退回逐項複製,是處理這類能力差異的經典手法。今天的寫法更簡潔:Array.from(nodeList) 或展開運算子 [...nodeList],兩者在現代瀏覽器都能正確處理 NodeList。
<!DOCTYPE html>
<html>
<head>
<title>JavaScript 設置「設為首頁」和「收藏頁面」</title>
<meta charset="utf-8">
<script type="text/javascript">
function setHomepage() {
if (document.all) {
/* IE */
document.body.style.behavior = 'url(#default#homepage)';
document.body.setHomePage(window.location.href);
} else if (window.sidebar) {
/* Firefox */
if (window.netscape) {
try {
netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
} catch (e) {
alert("該操作被瀏覽器拒絕,如果想啟用該功能,請在地址欄輸入 about:config,並將 signed.applets.codebase_principal_support 設為 true");
}
}
var prefs = Components.classes['@mozilla.org/preferences-service;1']
.getService(Components.interfaces.nsIPrefBranch);
prefs.setCharPref('browser.startup.homepage', window.location.href);
} else {
/* Chrome 或其他 */
alert("您的瀏覽器不支援自動設置首頁,請使用瀏覽器選單手動設置!");
}
}
</script>
</head>
<body>
<a onclick="setHomepage()" title="設為首頁" href="javascript:void(0);">設為首頁</a>
</body>
</html>
這段程式是個歷史產物:IE 靠 behavior 的 #default#homepage,舊版 Firefox 靠 Components 這套 XPCOM 介面。出於安全理由,現代瀏覽器早就全面禁止網頁改動首頁設定,所以這段程式今天只會走到最後的 alert 分支。留著當作理解「瀏覽器權限模型演進」的教材不錯,實際專案則不建議放這個按鈕。
<!DOCTYPE html>
<html>
<head>
<title>demo</title>
<meta charset="utf-8">
<script src="//code.jquery.com/jquery-1.11.0.min.js"></script>
<script src="//code.jquery.com/jquery-migrate-1.2.1.min.js"></script>
<script type="text/javascript">
jQuery.fn.addFavorite = function(l, h) {
return this.click(function() {
var t = jQuery(this);
if (jQuery.browser.msie) {
window.external.addFavorite(h, l);
} else if (jQuery.browser.mozilla || jQuery.browser.opera) {
t.attr("rel", "sidebar");
t.attr("title", l);
t.attr("href", h);
} else {
alert("請使用 Ctrl+D 將本頁加入收藏夾!");
}
});
};
$(function(){
$('#fav').addFavorite(document.title, location.href);
});
</script>
</head>
<body>
<a href="javascript:;" title="收藏本站" id="fav">收藏本站</a>
</body>
</html>
同樣的,這個範例依賴 jQuery.browser,而該 API 已在 jQuery 1.9 移除(要靠 jquery-migrate 才能勉強跑)。實務上現行的做法就是提示使用者按 Ctrl+D(Windows)或 Cmd+D(Mac),因為瀏覽器基於安全與垃圾網站防制,不允許頁面自行加入書籤。
做特性偵測(feature detection)時,最快的辦法就是「建一個該元素,看屬性在不在上面」:
function elementSupportsAttribute(element, attribute) {
var test = document.createElement(element);
return attribute in test;
}
用法:
if (elementSupportsAttribute("textarea", "placeholder")) {
// 支援,直接用原生 placeholder
} else {
// 不支援,走自訂的提示文字方案
}
這個思路比判斷瀏覽器版本先進得多——版本號會騙人(使用者可能改了 UA),而「這個環境到底有沒有這個能力」是可以直接問出來的。它也是 Modernizr 這類函式庫的核心原理。
全域變數會互相污染,把相關的東西收攏進一個物件是基本衛生:
var GLOBAL = {};
GLOBAL.namespace = function(str){
var arr = str.split('.'), o = GLOBAL;
for (k = (arr[0] == "GLOBAL") ? 1 : 0; k < arr.length; k++) {
o[arr[k]] = o[arr[k]] || {};
o = o[arr[k]];
}
}
使用方式:
GLOBAL.namespace("Lang");
GLOBAL.Lang.test = function(){
// todo
}
它做的事就是按點符號拆開字串,逐層確保中間物件存在(不存在就建一個空物件),最後回傳最內層。這樣一來,各模組都能掛在自己的子命名空間下,不必擔心互相覆蓋。
今天的做法:ES6 的模組系統(import/export)已經從語言層級解決了這個問題,每個檔案自帶作用域,不必再手動管理命名空間。只有在寫必須掛到 window 上的老式腳本時,才還需要這類工具函式。