寫前端單元測試時,最常遇到的難題是「怎麼驗證某個函式確實被呼叫過、而且只被呼叫一次」。QUnit 提供了 equal、ok 這類斷言,卻沒有 mock 能力。KMock 就是為填補這個空缺而生的極簡實作:它模擬函式行為,並記錄呼叫次數。
(function () {
var KMock = window.KMock = function () {};
KMock.prototype.setup = function (methodName) {
var instance = this;
instance[methodName] = {
returnAs: function (fn) {
instance["_" + methodName] = function () {
instance[methodName].invokeNum++;
fn.call();
};
},
isVerify: function (exceptNum) {
if (exceptNum != null) {
return exceptNum == instance[methodName].invokeNum;
} else {
return instance[methodName].invokeNum > 0;
}
},
invoke: function () {
instance["_" + methodName].call();
},
invokeNum: 0
};
return instance[methodName];
};
})();
這段程式只有三個關鍵設計。第一,setup(methodName) 會在被 mock 的物件上建立一個同名屬性,這個屬性其實是一個控制物件,負責設定行為與查詢狀態。第二,returnAs(fn) 把真正的替身函式藏在底層的 "_" + methodName 上,同時累加 invokeNum 計數器;呼叫 invoke() 就會觸發替身並讓計數加一。第三,isVerify(exceptNum) 作為斷言入口:傳入數字時比對精確次數,不傳則只檢查「是否至少被呼叫過一次」。
/// <reference path="Flight.js" />
/// <reference path="https://demo.jb51.net/jslib/qunit/qunit.js" />
/// <reference path="KMock.js" />
module("enter coin");
test("enter coin while game has not yet start", function () {
var flight = new KFlight();
var mock = new KMock();
mock.setup("draw").returnAs(function () {});
flight.draw = mock.draw.invoke;
equal(flight.coinNum, 0);
equal(flight.gameState, 0);
flight.coinEnter();
equal(flight.coinNum, 0);
equal(flight.gameState, 1);
equal(mock.draw.isVerify(1), true);
});
測試的意圖很清楚:遊戲尚未開始時投幣,分數不應該增加(coinNum 維持 0),但狀態應該切換到 1;同時 draw 這個繪圖函式必須恰好被呼叫一次。最後那行 mock.draw.isVerify(1) 就是在驗證「呼叫次數」 this 而非「呼叫結果」。
這個實作長度不到三十行,適合小型專案或教學示範。但正式專案仍建議使用成熟方案,例如 Sinon.js,它除了 call count 還提供參數比對、呼叫順序、throw 與 restore 等能力。KMock 的價值在於把 mock 的核心概念——替身、計數、驗證——濃縮到可以一眼讀完的程度。