這裡整理幾個實務上常會用到的 JavaScript 語法糖,每段都附上說明與示例。
/*
* @description: 型別檢查
* 透過此方法,可以檢查某個變量是否為期望的資料型別
* @params:
* obj 需要檢查的變量,必選
* config 資料型別白名單,可選,預設為全部型別
* @return: true 表示檢查通過,false 未通過
* @examples:
* typeCheck("str"); // true
* typeCheck({}, {"[object Array]": 1}); // false
*/
function typeCheck(obj, config) {
var hasOp = Object.prototype.hasOwnProperty,
toStr = Object.prototype.toString,
_config = config || {
"[object Object]": 1,
"[object Array]": 1,
"[object Regex]": 1,
"[object String]": 1,
"[object Number]": 1,
"[object Boolean]": 1,
"[object Function]": 1,
"[object Undefined]": 1,
"[object Null]": 1
};
return hasOp.call(_config, toStr.call(obj));
}
核心技巧是 Object.prototype.toString.call(obj),它會回傳形如 "[object Array]" 的標準字串,比 typeof 可靠得多——畢竟 typeof 對數組、null、Date 都給出 "object"。借用 hasOwnProperty 是為了避免 config 物件自身原型上的屬性造成誤判。
/*
* @description: 優雅地添加原型方法
* 在公共作用域執行此代碼片段即可
*/
if (typeof Function.prototype.method !== "function") {
Function.prototype.method = function (name, fn) {
this.prototype[name] = fn;
return this;
};
}
// 使用示例
function testFn() {}
testFn
.method("add", function (a, b) { return a + b; })
.method("sub", function (a, b) { return a - b; });
var testObj = new testFn();
testObj.add(1, 5); // 6
testObj.sub(7, 2); // 5
回傳 this 讓它能串鏈呼叫,讀起來像是在做宣告式設定。ES6 之後有了 class 語法,直接寫 class Test { add(a,b){...} } 更直觀,這個技巧主要還是在 ES5 環境裡發揮價值。
/*
* @function: 建立命名空間
* @params: ex 命名空間運算式,例如 NSROOT.service.impl
* 此運算式必須從根節點開始寫起
* @return: 回傳 Object,即運算式的最後一個節點
* @others: 若想換掉 NSROOT 這個命名,直接全域搜尋替換即可
*/
var NSROOT = NSROOT || {};
NSROOT.namespace = function (ex) {
var _ex = ex || "",
nsArray = _ex.split("."),
parentNode = NSROOT,
_s = "",
i = 0;
// 判斷命名空間是否從根節點開始
if (nsArray[0] !== "NSROOT") {
throw ("命名空間必須從根節點開始!");
}
nsArray = nsArray.slice(1); // 去掉 root 節點
for (i = 0; i < nsArray.length; i++) {
_s = nsArray[i];
if (parentNode[_s] === undefined) {
parentNode[_s] = {};
}
parentNode = parentNode[_s];
}
return parentNode;
};
// 使用示例
// 建立新的命名空間
var impl = NSROOT.namespace("NSROOT.service.impl");
alert(impl === NSROOT.service.impl); // true
// 對已存在的命名空間再呼叫一次,不會覆蓋原有資料
NSROOT.namespace("NSROOT.service.impl");
alert(impl === NSROOT.service.impl); // true
這個模式的做法是沿路檢查並補上中間節點,最後回傳最深處的物件,因此反覆呼叫是安全且冪等的。要注意 throw ("...") 拋的是字符串而非 Error 對象,實務上建議改成 throw new Error("..."),才能保留完整的堆疊資訊。另外,ES6 的模組系統(import/export)已經正式解決了命名空間問題,這段代碼現在主要用於維護老舊的全域腳本架構。