替 Array 擴充方法有兩條路:直接掛在 Array.prototype 上,或者用自己的工具函式包一層。前者方便,但有兩個明顯缺點——一是無法直接套用在 DOM 傳回的 NodeList(例如 document.getElementsByTagName('div'))上,二是污染了原生原型,對有潔癖的人來說破壞了原始生態。
YUI 的做法是包一個 YArray 建構函式,先判斷傳入的東西是不是陣列或類陣列,再決定怎麼處理:
YArray = function (o, idx, arraylike) {
var t = (arraylike) ? 2 : YArray.test(o),
l, a, start = idx || 0;
if (t) {
try {
// 借助 Array 原生方法把 arguments 轉成真陣列
return Array.prototype.slice.call(o, start);
} catch (e) {
a = [];
l = o.length;
for (; start < l; start++) { a.push(o[start]); }
return a;
}
} else {
return [o];
}
};
YArray.test = function (o) {
var r = 0;
if (o && (typeof o == 'object' || typeof o == 'function')) {
if (Object.prototype.toString.call(o) === "[object Array]") {
r = 1;
} else {
try {
if (('length' in o) && !o.tagName && !o.alert && !o.apply) { r = 2; }
} catch (e) {}
}
}
return r;
};
除了 slice,還有幾種等價寫法可以達到同樣目的(但 DOM 物件不行,只能自己遍歷):
Array.apply(null, arguments); [].slice.call(arguments, 0); [].splice.call(arguments, 0, arguments.length); [].concat.apply([], arguments);
而 DOM 集合只能老實搬:
a = [];
l = o.length;
for (; start < l; start++) { a.push(o[start]); }
return a;
// 遍歷,有傳 callback 就每輪執行
YArray.each = (Array.prototype.forEach) ?
function (a, f, o) {
Array.prototype.forEach.call(a || [], f, o || Y);
return YArray;
} :
function (a, f, o) {
var l = (a && a.length) || 0, i;
for (i = 0; i < l; i = i + 1) { f.call(o || Y, a[i], i, a); }
return YArray;
};
// 兩個陣列組裝成鍵值對(等同一個 JSON 物件)
YArray.hash = function (k, v) {
var o = {}, l = k.length, vl = v && v.length, i;
for (i = 0; i < l; i = i + 1) {
if (k[i]) { o[k[i]] = (vl && vl > i) ? v[i] : true; }
}
return o;
};
// 尋找索引,找不到回傳 -1
YArray.indexOf = (Array.prototype.indexOf) ?
function (a, val) { return Array.prototype.indexOf.call(a, val); } :
function (a, val) {
for (var i = 0; i < a.length; i = i + 1) {
if (a[i] === val) { return i; }
}
return -1;
};
// 數值排序(由小到大;改成 return (b - a) 即由大到小)
YArray.numericSort = function (a, b) { return (a - b); };
// 是否有任一元素通過 callback
YArray.some = (Array.prototype.some) ?
function (a, f, o) { return Array.prototype.some.call(a, f, o); } :
function (a, f, o) {
var l = a.length, i;
for (i = 0; i < l; i = i + 1) {
if (f.call(o, a[i], i, a)) { return true; }
}
return false;
};
寫法上有一個共同套路:先偵測瀏覽器是否原生支援,有就呼叫原生實作,沒有才退回手寫迴圈。這樣既拿到效能,又保住相容性。
JavaScript 1.6 到 1.8 陸續加入了 every、filter、forEach、indexOf、lastIndexOf、map、some、reduce、reduceRight。以下示範幾個關鍵的:
// 是否「每一個」元素都通過 callback
if (!Array.prototype.every) {
Array.prototype.every = function (fun /*, thisp */) {
var len = this.length >>> 0;
if (typeof fun != "function") throw new TypeError();
var thisp = arguments[1];
for (var i = 0; i < len; i++) {
if (i in this && !fun.call(thisp, this[i], i, this)) return false;
}
return true;
};
}
// 過濾器:把通過 callback 的元素收集成新陣列
Array.prototype.filter = function (block /*, thisp */) {
var values = [];
var thisp = arguments[1];
for (var i = 0; i < this.length; i++)
if (block.call(thisp, this[i])) values.push(this[i]);
return values;
};
// 用法:numbers.filter(function (t) { return t < 5; })
// map:每個元素交給 callback 處理,回傳處理後的新陣列
Array.prototype.map = function (fun /*, thisp */) {
var len = this.length >>> 0;
if (typeof fun != "function") throw new TypeError();
var res = new Array(len);
var thisp = arguments[1];
for (var i = 0; i < len; i++) {
if (i in this) res[i] = fun.call(thisp, this[i], i, this);
}
return res;
};
// 用法:[1, 4, 9].map(function (a) { return a * 2; }) → [2, 8, 18]
reduce 是「收斂」的概念:讓元素依序呼叫同一個函式,把結果往下一輪傳,最後只剩一個值。因此 callback 一定要有回傳值;reduceRight 只是把方向改成從右往左。
Array.prototype.reduce = function (fun /*, initial */) {
var len = this.length >>> 0;
if (typeof fun != "function") throw new TypeError();
if (len == 0 && arguments.length == 1) throw new TypeError();
var i = 0;
if (arguments.length >= 2) {
var rv = arguments[1];
} else {
do {
if (i in this) { rv = this[i++]; break; }
if (++i >= len) throw new TypeError();
} while (true);
}
for (; i < len; i++) {
if (i in this) rv = fun.call(null, rv, this[i], i, this);
}
return rv;
};
除了這些內建方法,任何常用的小工具都能掛上去,例如把 toString 改成無分隔串接:
Array.prototype.toString = function () { return this.join(''); };
也可以再加 toJson、uniq(去重)、compact(去除假值)等等。不過要提醒的是:擴充原生原型在多人協作的專案裡容易造成衝突,如今更推薦把這些工具放進獨立命名空間(如 YUI 的 YArray)或直接沿用 ES5 以後的原生方法。Array 的擴充對開發確實幫助很大,但用得克制才是好習慣。