現在軟體開發越來越重視單元測試,它既能提升開發效率,也能守住品質底線。過去單元測試多見於伺服器端,但隨著 Web 開發的分工日益細緻,前端 JavaScript 同樣可以做單元測試。
伺服器端已有各式各樣成熟的測試框架,JavaScript 這邊也有不少優秀選擇。本文不打算介紹既有框架,而是帶你從零手寫一個最簡單的單元測試框架,透過一連串重構理解它的核心概念。JS 單元測試的面向很多,本文聚焦在「方法功能檢查」,瀏覽器相容性檢查不在此列。
待測程式碼是我先前寫的日期格式化函式,用法類似 C# 的字串格式化:
Date.prototype.toString = function(format){
var time = {};
time.Year = this.getFullYear();
time.TYear = (""+time.Year).substr(2);
time.Month = this.getMonth()+1;
time.TMonth = time.Month < 10 ? "0"+time.Month : time.Month;
time.Day = this.getDate();
time.TDay = time.Day < 10 ? "0"+time.Day : time.Day;
time.Hour = this.getHours();
time.THour = time.Hour < 10 ? "0"+time.Hour : time.Hour;
time.hour = time.Hour < 13 ? time.Hour : time.Hour-12;
time.Thour = time.hour < 10 ? "0"+time.hour : time.hour;
time.Minute = this.getMinutes();
time.TMinute = time.Minute < 10 ? "0"+time.Minute : time.Minute;
time.Second = this.getSeconds();
time.TSecond = time.Second < 10 ? "0"+time.Second : time.Second;
time.Millisecond = this.getMilliseconds();
var oNumber = time.Millisecond/1000;
if(format != undefined && format.replace(/\s/g,"").length > 0){
format = format
.replace(/yyyy/ig, time.Year)
.replace(/yyy/ig, time.Year)
.replace(/yy/ig, time.TYear)
.replace(/y/ig, time.TYear)
.replace(/MM/g, time.Month) // 刻意留下的 bug:少了補零
.replace(/M/g, time.Month)
.replace(/dd/ig, time.TDay)
.replace(/d/ig, time.Day)
.replace(/HH/g, time.THour)
.replace(/H/g, time.Hour)
.replace(/hh/g, time.Thour)
.replace(/h/g, time.hour)
.replace(/mm/g, time.TMinute)
.replace(/m/g, time.Minute)
.replace(/ss/ig, time.TSecond)
.replace(/s/ig, time.Second)
.replace(/fff/ig, time.Millisecond)
.replace(/ff/ig, oNumber.toFixed(2)*100)
.replace(/f/ig, oNumber.toFixed(1)*10);
}
else{
format = time.Year+"-"+time.Month+"-"+time.Day+" "+time.Hour+":"+time.Minute+":"+time.Second;
}
return format;
}
為了示範,我把 .replace(/MM/g, time.TMonth) 故意改成 .replace(/MM/g, time.Month)——這個 bug 的表現是:月份小於 10 時沒有補零成兩位數。
常聽人說「好的設計都是重構出來的」,下面就用這個 bug 當靶子,一步步改良測試方式。
最偷懶的做法就是直接 alert 看結果:
<!DOCTYPE html>
<html>
<head>
<title>Demo</title>
<meta charset="utf-8"/>
</head>
<body>
<script type="text/javascript">
Date.prototype.toString = function(format){
// ...(同上,MM 使用 time.Month)
}
var date = new Date(2012, 3, 9);
alert(date.toString("yyyy"));
alert(date.toString("MM"));
</script>
</body>
</html>
執行後依序彈出 2012 與 4,由此判斷 date.toString("MM") 有問題。
這種方式很不方便:它只給出結果,不告訴你對錯。除非對程式碼極為熟悉,否則很難判斷彈出來的值是正是誤。
斷言(assert)表達的是開發者對系統應有狀態的預期。比如有個加法方法,對 3 + 2 我們預期回傳 5,回傳 5 就通過,否則給出錯誤提示。斷言是單元測試的核心,所有測試框架都內建這個能力。我們先寫一個最簡單的版本:
function assert(message, result){
if(!result){
throw new Error(message);
}
return true;
}
兩個參數分別是失敗時的提示訊息與斷言結果。使用方式:
var date = new Date(2012, 3, 9);
try{
assert("yyyy should return full year", date.toString("yyyy") === "2012");
}catch(e){
alert("Test failed:" + e.message);
}
try{
assert("MM should return full month", date.toString("MM") === "04");
}
catch(e){
alert("Test failed:" + e.message);
}
執行後會彈出失敗提示:

assert 雖然能給出明確結果,但要做一系列測試時,每個都要包 try/catch 仍然麻煩。而且一般測試框架都會統計成功數、失敗數與失敗訊息。
為了讓結果直接呈現在頁面上,先寫一個帶顏色的小輸出函式:
function PrintMessage(text, color){
var div = document.createElement("div");
div.innerHTML = text;
div.style.color = color;
document.body.appendChild(div);
delete div;
}
再寫一個類似 jsTestDriver 中 TestCase 的函式來批次執行:
function testCase(name, tests){
var successCount = 0;
var testCount = 0;
for(var test in tests){
testCount++;
try{
tests[test]();
PrintMessage(test + " success", "#080");
successCount++;
}
catch(e){
PrintMessage(test + " failed:" + e.message, "#800");
}
}
PrintMessage("Test result: " + testCount + " tests, " + successCount + " success, " +
(testCount - successCount) + " failures", "#800");
}
測試程式碼:
var date = new Date(2012, 3, 9);
testCase("date toString test", {
yyyy: function(){
assert("yyyy should return 2012", date.toString("yyyy") === "2012");
},
MM: function(){
assert("MM should return 04", date.toString("MM") === "04");
},
dd: function(){
assert("dd should return 09", date.toString("dd") === "09");
}
});
結果:

一眼就能看出哪個案例出錯。但這樣就完美了嗎?注意 var date = new Date(2012, 3, 9) 是定義在 testCase 外部、被所有測試案例共用的。這裡因為各方法都沒有改動 date 所以沒出問題;一旦某個測試案例修改了 date,後續測試的結果就不可信了。
多數測試框架都提供 setUp 與 tearDown,分別負責準備與銷毀測試資料。加上它們:
testCase("date toString", {
setUp: function(){
this.date = new Date(2012, 3, 9);
},
tearDown: function(){
delete this.date;
},
yyyy: function(){
assert("yyyy should return 2012", this.date.toString("yyyy") === "2012");
},
MM: function(){
assert("MM should return 04", this.date.toString("MM") === "04");
},
dd: function(){
assert("dd should return 09", this.date.toString("dd") === "09");
}
});
由於 setUp 與 tearDown 本身不是測試案例,testCase 也要相應調整:
function testCase(name, tests){
var successCount = 0;
var testCount = 0;
var hasSetUp = typeof tests.setUp == "function";
var hasTearDown = typeof tests.tearDown == "function";
for(var test in tests){
if(test === "setUp" || test === "tearDown"){
continue;
}
testCount++;
try{
if(hasSetUp){
tests.setUp();
}
tests[test]();
PrintMessage(test + " success", "#080");
if(hasTearDown){
tests.tearDown();
}
successCount++;
}
catch(e){
PrintMessage(test + " failed:" + e.message, "#800");
}
}
PrintMessage("Test result: " + testCount + " tests, " + successCount + " success, " +
(testCount - successCount) + " failures", "#800");
}
執行結果與第三版相同,但每個案例都有獨立的資料,互不干擾。
好的設計來自持續重構。第四版当然不是終點——它沒有 tearDown 在失敗時的保證執行、沒有非同步測試支援、沒有測試分組與結果報告。這只是一個入門示例,目的是讓初學者對 JS 單元測試有個具體概念。
實務上,與其自己攢框架,不如直接用 Jasmine、Mocha、Jest 或 Vitest 這類成熟方案,把力氣花在寫好測試案例上。本文參考了《測試驅動的 JavaScript 開發》第一章(推薦一讀),書中的案例同樣是時間函式,只是寫得更完整、對初學者稍嫌複雜。
本文屬拋磚引玉,歡迎各路高手補充指正。
作者:Artwl