Angular單元測試淺說

原文鏈接
做了多年的Angular的前端開發,一直沒有膽量對前端進行單元測試,原因一是前端是跟用戶打交道,不好測試,原因二是項目的時間壓力沒有精力弄單元測試。這也就導致在前端開發時,業務一旦改變,就要人肉進行測試。費時又沒有技術含量,直接讓我懷疑人生。最近得空,索性就把Angular的單元測試研究了一把。Angular其實自己有單元測試的工具:Karma + Jasmine:

  • Karma:Karma是為測試JavaScript代碼而生的自動化測試管理工具,可監控文件的變化,自動執行測試。
  • Jasmine:用來編寫Javascript測試的的框架。

第一個測試用例

當創建Angular應用后,在package.json文件中已經添加了Karma和Jasmine的依賴性:

"karma": "~1.7.1",  
"karma-chrome-launcher": "~2.2.0",
"karma-coverage-istanbul-reporter": "~2.0.0",
"karma-jasmine": "~1.1.1",
"karma-jasmine-html-reporter": "^0.2.2",

做過后端測試的同行,估計已經知道這些組件的分工了:

  • karma:Karma核心組件
  • karma-chrome-launcher:Chrome發射器,測試會在Chrome上執行
  • karma-coverage-istanbul-reporter:coverage報告
  • karma-jasmine:Jasmine核心組件
  • karma-jasmine-html-reporter:Html測試報告

在src目錄下會看到名為:karma.conf.js、test.ts的兩個文件。

karma.conf.js:Karma的配置文件,其中需要重點關注的配置有:

  • frameworks:使用的測試框架,這里使用Jasmine

  • port:測試使用的端口

  • autoWatch:是否自動監測測試代碼的改變,自動執行測試

  • plugins:測試使用到的插件,與package.json文件保持一致

  • browsers:測試運行使用的瀏覽器,這里使用Chrome,如果你需要使用其他瀏覽器,需要通過npm安裝瀏覽器發射器,并在plugins和這里設置,例如使用Safari:

    npm install karma-safari-launcher --save-dev
    
    plugins: [
        require('karma-safari-launcher')
    ]
    browsers: ['Safari'],
    

test.ts:測試入口文件,其中初始化了測試環境以及指定所有測試文件

在app目錄下,還會找到一個名為app.component.spec.ts的文件,這就是一個Jasmine的測試,內容如下:

import { TestBed, async } from '@angular/core/testing';
import { AppComponent } from './app.component';
//測試入口,參數為測試名、方法
describe('AppComponent', () => {
  //每個測試用的Setup
  beforeEach(async(() => {
    TestBed.configureTestingModule({
      declarations: [
        AppComponent  
      ],
    }).compileComponents();
  }));

  //測試用例
  it('should create the app', async(() => {
    const fixture = TestBed.createComponent(AppComponent);
    const app = fixture.debugElement.componentInstance;
    expect(app).toBeTruthy();
  }));

  it(`should have as title 'test-demo'`, async(() => {
    const fixture = TestBed.createComponent(AppComponent);
    const app = fixture.debugElement.componentInstance;
    //斷言,期望值是否滿足要求
    expect(app.title).toEqual('test-demo');
  }));

  it('should render title in a h1 tag', async(() => {
    const fixture = TestBed.createComponent(AppComponent);
    fixture.detectChanges();
    const compiled = fixture.debugElement.nativeElement;
    //通過querySelector獲取頁面元素
    expect(compiled.querySelector('h1').textContent).toContain('Welcome to test-demo!');
  }));

  //每個測試用例的TearDown
  afterEach(function() {
    //清除測試數據
  });
});

上述代碼使用了Jasmine的語法,關于Jasmine的更詳細介紹,參見JavaScript 單元測試框架:Jasmine 初探。這里不贅述。

執行: ng test,就會看到上述文件的測試報告:

測試報告

另外在測試報告中還可單擊某個測試單獨執行,報告如下:

測試報告

填坑

對于Pipe、Service、Router等組件的測試,可參見Angular文檔,這里重點講述下在測試中遇到的各種坑。

No provider ***

測試時,如果被測組件需要其他第三方組件、servcie或pipe,沒有被引入,就會出現No provider
的錯誤,解決方法很簡單,在beforeEach中使用imports或provider引入即可:

beforeEach(async(() => {
    TestBed.configureTestingModule({
      declarations: [
        //這里聲明
      ],
      imports: [
        //這里引入
      ],
      providers: [
        //這里引入
      ],
      schemas: [CUSTOM_ELEMENTS_SCHEMA],
    })
      .compileComponents();
  }));

請求超時

在開發時,異步請求由于網絡原因常會出現TimeOut的錯誤,通常的解決方法是設置TimeOut時間的上限,并對TimeOut錯誤作出人性化的提示。在測試時也同樣會發生TimeOut的錯誤:

TimeOut

解決辦法是可以在某個測試用例中設置TimeOut的時間:

it('#loadBalance for BCT should return real value', async () => {
  jasmine.DEFAULT_TIMEOUT_INTERVAL = 1000000;
  ...
})

或者在BeforeEach中統一設置TimeOut時間:

describe("my async specs", function() {
    var originalTimeout;
    beforeEach(function() {
      originalTimeout = jasmine.DEFAULT_TIMEOUT_INTERVAL;
      jasmine.DEFAULT_TIMEOUT_INTERVAL = 1000000;
    });

    ...

    afterEach(function() {
      jasmine.DEFAULT_TIMEOUT_INTERVAL = originalTimeout;
    });
  });

定義測試Environment

Angular缺省針對開發和產品提供了不同的Environment,對于測試,我們同樣可以設置Enviroment。

在src/environment下創建environment.test.ts,并修改angular.json內容:

"architect":{
    "test":{
        ...
        "configurations": {
            "test": {
              "fileReplacements": [
                {
                  "replace": "src/environments/environment.ts",
                  "with": "src/environments/environment.test.ts"
                }
              ]
            }
          }
    }
}

修改package.json文件:

"scripts": {
  "test": "ng test --configuration=test",
}

這樣執行如下命令:

npm test
//或者
ng test --configuration=test

執行測試時,使用的就是environment.test.ts文件中配置的內容。

測試數據回滾

做過Grails開發的伙計應該知道,單元測試、集成測試后,數據庫中的測試數據會通過配置文件清除掉。在前端測試中,測試數據需要自行調用清除代碼,對于使用LocalStorage、SessionStorage保持的數據亦是如此,方法很簡單,在afterEach添加清除代碼:

describe("my async specs", function() {
  
  afterEach(function() {
    //在這里清除測試數據
  });
});

與StoryBook的配合

先前我發布了一篇題為《StoryBook實戰》的文章,StoryBook也是用來測試組件的,它與Karma+Jasmine有什么區別呢?

二者都能測試的:

  1. Pipe
  2. Servcie
  3. Component

StoryBook不能測、Karma + Jasmine可測試的:

  1. Router
  2. Component的界面元素屬性、Input、Output

Karma + Jasmine不能做的,StoryBook能做的:

  1. Component交互測試
  2. 組件管理
  3. 編寫組件文檔

從上面可以看出,Storybook進行的是黑盒測試,Karma + Jasmine則注重白盒測試,二者側重點不同,沒有誰強誰弱之分,只有揚長避短,利用好各自的優點,方可讓前端測試更完美,將前端bug扼殺在開發階段。

一些前端測試感悟

雖然前端開發的工作比較繁瑣,也是客戶Challenge最多的地方,但是不代表前端只有頁面,沒有架構。以前之所以覺得Angular的單元測試難做,就是覺得都是頁面的東西怎么測?其實,終其原因,還是沒有架構,所有的代碼都集中在Component中,為了趕進度,通過拷貝、粘貼,怎么快怎么來。結果,悲劇了,后期代碼維護困難,一點改動就需要人肉測試。費時不說,開發人員也沒有成長。接觸Angular前端測試后,我的腦海里又出現了“測試驅動開發”。一段好代碼,前提是要易于測試,不管這段代碼是用于前端還是后端。
前端開發人員不僅僅要關注頁面的易用性、美觀性,同樣需要關注前端的架構,一個易于測試的架構才是最好的“武器”。

參考文檔

  1. StoryBook實戰
  2. JavaScript 單元測試框架:Jasmine 初探
  3. Karma簡介
  4. Angular文檔——測試篇
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,505評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,556評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,463評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,009評論 1 312
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,778評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,218評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,281評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,436評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,969評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,795評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,993評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,537評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,229評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,659評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,917評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,687評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,990評論 2 374

推薦閱讀更多精彩內容