JavaScript 的陣列內建方法雖然够用,卻少了幾個做數據處理時幾乎天天要用的統計函式。下面這份程式碼把最大值、最小值、總和、平均值一次補齊,而且同時掛到 jQuery、jQuery 物件與 Array 原型上,三種呼叫風格都支援。
/****************************************************
* CreateBy: joe zhou
* Description: 陣列統計函式
****************************************************/
$.extend({
max: function (arr) {
return cacl(arr, function (item, max) {
if (!(max > item)) { return item; } else { return max; }
});
},
min: function (arr) {
return cacl(arr, function (item, min) {
if (!(min < item)) { return item; } else { return min; }
});
},
sum: function (arr) {
return cacl(arr, function (item, sum) {
if (typeof (sum) == 'undefined') { return item; }
else { return sum += item; }
});
},
avg: function (arr) {
if (typeof (arr) == 'undefined' || arr.length == 0) { return 0; }
return this.sum(arr) / arr.length;
}
});
$.fn.extend({
max: function () { return $.max(this.get()); },
min: function () { return $.min(this.get()); },
sum: function () { return $.sum(this.get()); },
avg: function () { return $.avg(this.get()); }
});
function cacl(arr, callback) {
var ret;
for (var i = 0; i < arr.length; i++) {
ret = callback(arr[i], ret);
}
return ret;
}
Array.prototype.max = function () {
return cacl(this, function (item, max) {
if (!(max > item)) { return item; } else { return max; }
});
};
Array.prototype.min = function () {
return cacl(this, function (item, min) {
if (!(min < item)) { return item; } else { return min; }
});
};
Array.prototype.sum = function () {
return cacl(this, function (item, sum) {
if (typeof (sum) == 'undefined') { return item; }
else { return sum += item; }
});
};
Array.prototype.avg = function () {
if (this.length == 0) { return 0; }
return this.sum(this) / this.length;
};
核心是一個名為 cacl 的累加器:它走訪陣列,把「目前元素」與「目前結果」交給回呼函式,再由回呼決定新的結果是什麼。四個統計函式其實只是四段不同的比較邏輯,共用同一套迴圈。這種把「遍歷」與「運算」分開的寫法,正是 reduce 的精神。
能跑,但有幾處值得修正,改一改會是很好的練習。
avg 的實作有 bug。Array 版本寫成 this.sum(this),但 sum 已經掛在原型上,正確寫法是 this.sum()。多傳一個參數雖然不會報錯,語意卻是錯的。
空陣列的行為不一致。avg([]) 回傳 0,但 [].max() 與 [].min() 會回傳 undefined,呼叫端得自己處理。比較好的做法是四個函式對空陣列有一致的約定,或者直接拋出錯誤。
max 與 min 的比較寫法繞了一圈。if (!(max > item)) 等價於 if (max <= item),直接寫出來可讀性更好。而 NaN 在這種比較下會產生反直覺的結果,最好先過濾掉非數字。
用 cacl 這個名字。拼字錯誤,且太短不易理解,改叫 reduce 或 aggregate 都比它清楚。
污染 Array.prototype 風險很高。直接在內建原型上加屬性,可能與其他函式庫或未來的語言規格相撞。而且用 for...in 走訪陣列時,這些新方法會被一起列出來,造成難以追查的 bug。除非你很清楚自己在做什麼,否則不建議這麼做。
今天要達到同樣目的,根本不需要擴充原型,原生方法已經足夠:
const nums = [3, 9, 1, 7];
Math.max(...nums) // 9
Math.min(...nums) // 1
nums.reduce((a, b) => a + b, 0) // 20
nums.reduce((a, b) => a + b, 0) / nums.length // 5
空陣列時 Math.max(...[]) 會回傳 -Infinity,這點要留意,記得先判斷長度。
如果只是想讓 jQuery 物件(也就是選到的元素集合)能做統計,比較安全的做法是用靜態工具函式而非改寫原型:
const stats = {
max: arr => arr.length ? Math.max(...arr) : undefined,
min: arr => arr.length ? Math.min(...arr) : undefined,
sum: arr => arr.reduce((a, b) => a + b, 0),
avg: arr => arr.length ? arr.reduce((a, b) => a + b, 0) / arr.length : 0
};
// 搭配 jQuery 使用
const $items = $('.item');
stats.sum($items.map((i, el) => Number(el.dataset.value)).get());
用純函式而非改寫原型,最大的好處是不必記得「這個方法從哪來」,也不會與別人的程式碼互相干擾。