
寫單元測試和寫專案程式碼不太一樣:你得準備資料、mock 物件、呼叫專案 API,再驗證結果。而且測試程式碼往往比被測程式碼大得多。Real-World Testing with XCTest 一文就提到:「到目前為止,我們的程式碼庫已經橫跨 190 個檔案、18,000 行程式碼,達到 544 kB;而測試部分的程式碼現在差不多有 1,200 kB,大概是被測程式碼的兩倍。」那麼該怎麼訂立規範,讓測試程式碼更乾淨、可讀性更高?以下四條是我們團隊的實踐。
(基於保密需求,文中程式碼的命名在不影響理解的前提下都做了調整。)
每個 case 本質上都是三步走:mock 物件並準備測試資料、呼叫目標 API、驗證輸出與行為。因此可以用三段式把程式碼分區:
- (void)testNeedToShowRowWhenTypeIsAll {\n // given\n _sut.collectionType = 1;\n NSIndexPath *path1 = [NSIndexPath indexPathForRow:1 inSection:1];\n // when\n BOOL needToShow1 = [_sut needToShowRow:path1];\n // then\n assertThatBool(needToShow1, isTrue());\n}一眼掃過去就能看出這個 case 大致在做什麼。
假設我們呼叫的 API 內部有 if…else…,建議 if 一個 case、else 一個 case,分開測試。這樣每個 case 都很清楚自己在測什麼。若全部混在一個 case 裡,可讀性會大幅下降,case 體積也會變大,因為你得寫兩次 Given-When-Then。更不建議在 case 裡寫 for 迴圈做驗證。
有人會說:我的測試目標函數裡有很多 if…else…。那麼我認為你該重新檢視一下設計了。
結論很簡單:一個 Case 只測一種情況,不同情況用方法名標明:
- (void)testNeedToShowRowWhenTypeIsAll { ... }\n- (void)testNeedToShowRowWhenTypeIsOnSell { ... }一個測試檔案只有一個被測類別。但當測試檔案越來越多,看某個 case 時往往要讀完才知道被測的是誰;就算看檔名(XXXXXXTest.m)能推斷,也不夠直觀。所以不論在哪個測試檔案、被測類別叫什麼名字,一律用一個成員變數 _sut 來指向它,一眼就知道對象是誰。
_sut 是 System Under Test 的縮寫。
@implementation JHSCollectionDataSourceTest {\n JHSCollectionDataSource *_sut;\n}\n\n- (void)testNeedToShowHeaderWhenTypeIsAll {\n // given\n _sut.collectionType = 1;\n // when\n BOOL needToShow1 = [_sut needToShowHeader:1];\n // then\n assertThatBool(needToShow1, isTrue());\n}測試 case 裡呼叫的方法,可能會改動某個私有屬性、或呼叫某個私有方法。如何優雅地驗證這種行為?可以在測試檔案開頭用一個名為 UnitTest 的 category 把私有方法與屬性暴露出來(屬性暴露的其實是對應的 getter 與 setter):
@interface JHSTestDataSource (UnitTest)\n- (NSInteger)getSellGroupCount;\n- (BOOL)needShowHeader:(NSInteger)section;\n@end
規範本身不複雜,關鍵是團隊一致地執行下去。enjoy it!