DIV CSS 佈局教程網

KMock:用二十行打造輕量 JavaScript Mock 框架做單元測試
編輯:關於JavaScript     

寫前端單元測試時,最常遇到的難題是「怎麼驗證某個函式確實被呼叫過、而且只被呼叫一次」。QUnit 提供了 equal、ok 這類斷言,卻沒有 mock 能力。KMock 就是為填補這個空缺而生的極簡實作:它模擬函式行為,並記錄呼叫次數。

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) 作為斷言入口:傳入數字時比對精確次數,不傳則只檢查「是否至少被呼叫過一次」。

搭配 QUnit 使用

/// <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 的核心概念——替身、計數、驗證——濃縮到可以一眼讀完的程度。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved