以下是我假定那些極少或壓根沒寫單元測(cè)試的人準(zhǔn)備的，因此，會(huì)白話解釋諸多概念性問(wèn)題，同時(shí)會(huì)結(jié)合 Jasmine 與之對(duì)應(yīng)的方法進(jìn)行講解。

一、概念

Test Suite

測(cè)試套件，哪怕一個(gè)簡(jiǎn)單的類，也會(huì)有若干的測(cè)試用例，因此將這些測(cè)試用例集合在一個(gè)分類下就叫Test Suite。

而在 Jasmine 就是使用 describe 全局函數(shù)來(lái)表示，它的第一個(gè)字符串參數(shù)用來(lái)表示Suite的名稱或標(biāo)題，第二個(gè)方法參數(shù)就是實(shí)現(xiàn)Suite代碼了。

describe('test suite name', () => {
});

Specs

一個(gè)Specs相當(dāng)于一個(gè)測(cè)試用例，也就是我們實(shí)現(xiàn)測(cè)試具體代碼體。

Jasmine 就是使用 it 全局函數(shù)來(lái)表示，和 describe 類似，字符串和方法兩個(gè)參數(shù)。

而每個(gè) Spec 內(nèi)包括多個(gè) expectation 來(lái)測(cè)試需要測(cè)試的代碼，只要任何一個(gè) expectation 結(jié)果為 false 就表示該測(cè)試用例為失敗狀態(tài)。

describe('demo test', () => {
    const VALUE = true;
    it('should be true', () => {
        expect(VALUE).toBe(VALUE);
    })
});

Expectations

斷言，使用 expect 全局函數(shù)來(lái)表示，只接收一個(gè)代表要測(cè)試的實(shí)際值，并且需要與 Matcher 代表期望值。

二、常用方法

Matchers

斷言匹配操作，在實(shí)際值與期望值之間進(jìn)行比較，并將結(jié)果通知Jasmine，最終Jasmine會(huì)判斷此 Spec 成功還是失敗。

Jasmine 提供非常豐富的API，一些常用的Matchers：

• toBe() 等同 ===
• toNotBe() 等同 !==
• toBeDefined() 等同 !== undefined
• toBeUndefined() 等同 === undefined
• toBeNull() 等同 === null
• toBeTruthy() 等同 !!obj
• toBeFalsy() 等同 !obj
• toBeLessThan() 等同 <
• toBeGreaterThan() 等同 >
• toEqual() 相當(dāng)于 ==
• toNotEqual() 相當(dāng)于 !=
• toContain() 相當(dāng)于 indexOf
• toBeCloseTo() 數(shù)值比較時(shí)定義精度，先四舍五入后再比較。
• toHaveBeenCalled() 檢查function是否被調(diào)用過(guò)
• toHaveBeenCalledWith() 檢查傳入?yún)?shù)是否被作為參數(shù)調(diào)用過(guò)
• toMatch() 等同 new RegExp().test()
• toNotMatch() 等同 !new RegExp().test()
• toThrow() 檢查function是否會(huì)拋出一個(gè)錯(cuò)誤

而這些API之前用 not 來(lái)表示負(fù)值的判斷。

expect(true).not.toBe(false);

這些Matchers幾乎可以滿足我們?nèi)粘Ｐ枨?，?dāng)然你也可以定制自己的Matcher來(lái)實(shí)現(xiàn)特殊需求。

Setup 與 Teardown

一份干將的測(cè)試代碼很重要，因此我們可以將這些重復(fù)的 setup 與 teardown 代碼，放在與之相對(duì)應(yīng)的 beforeEach 與 afterEach 全局函數(shù)里面。

beforeEach 表示每個(gè) Spec 執(zhí)行之前，反之。

describe('demo test', () => {
    let val: number = 0;
    beforeEach(() => {
        val = 1;
    });
    it('should be true', () => {
        expect(val).toBe(1);
    });
    it('should be false', () => {
        expect(val).not.toBe(0);
    });
});

數(shù)據(jù)共享

如同上面示例中，我們可以在每個(gè)測(cè)試文件開頭、describe 來(lái)定義相應(yīng)的變量，這樣每個(gè) it 內(nèi)部可以共享它們。

當(dāng)然，每個(gè) Spec 的執(zhí)行周期間也會(huì)伴隨著一個(gè)空的 this 對(duì)象，直至 Spec 執(zhí)行結(jié)束后被清空，利用 this 也可以做數(shù)據(jù)共享。

嵌套代碼

有時(shí)候當(dāng)我們對(duì)某個(gè)組件進(jìn)行測(cè)試時(shí)，而這個(gè)組件會(huì)有不同狀態(tài)來(lái)展示不同的結(jié)果，這個(gè)時(shí)候如果只用一個(gè) describe 會(huì)顯得不過(guò)優(yōu)雅。

因此，嵌套 describe，會(huì)讓測(cè)試代碼、測(cè)試報(bào)告看起來(lái)更漂亮。

describe('AppComponent', () => {
    describe('Show User', () => {
        it('should be show panel.', () => {});
        it('should be show avatar.', () => {});
    });
    describe('Hidden User', () => { 
        it('should be hidden panel.', () => {});
    });
});

跳過(guò)測(cè)試代碼塊

需求總是三心二意的，但好不容易寫好的測(cè)試代碼，難道要?jiǎng)h除嗎？非也……

Suites 和 Specs 分別可以用 xdescribe 和 xit 全局函數(shù)來(lái)跳過(guò)這些測(cè)試代碼塊。

三、配合Angular工具集

Spy

Angular的自定義事件實(shí)在太普遍了，但為了測(cè)試這些自定義事件，因此監(jiān)控事件是否正常被調(diào)用是非常重要。好在，Spy 可以用于監(jiān)測(cè)函數(shù)是否被調(diào)用，這簡(jiǎn)直就是我們的好伙伴。

以下示例暫時(shí)無(wú)須理會(huì)，暫且體驗(yàn)一下：

describe('AppComponent', () => {
    let fixture: ComponentFixture<TestComponent>;
    let context: TestComponent;

    beforeEach(() => {
        TestBed.configureTestingModule({
            declarations: [TestComponent]
        });
        fixture = TestBed.createComponent(TestComponent);
        context = fixture.componentInstance;
        // 監(jiān)聽onSelected方法
        spyOn(context, 'onSelected');
        fixture.detectChanges();
    });

    it('should be called [selected] event.', () => {
        // 觸發(fā)selected操作

        // 斷言是否被調(diào)用過(guò)
        expect(context.onSelected).toHaveBeenCalled();
    });
});

異步支持

首先，這里的異步是指帶有 Observable 或 Promise 的異步行為，因此對(duì)于組件在調(diào)用某個(gè) Service 來(lái)異步獲取數(shù)據(jù)時(shí)的測(cè)試狀態(tài)。

假設(shè)我們的待測(cè)試組件代碼：

export class AppComponent {
  constructor(private _user: UserService) {}

  query() {
    this._user.quer().subscribe(() => {});
  }
}

async

async 無(wú)任何參數(shù)與返回值，所有包裹代碼塊里的測(cè)試代碼，可以通過(guò)調(diào)用 whenStable() 讓所有待處理異步行為都完成后再進(jìn)行回調(diào)；最后，再進(jìn)行斷言操作。

it('should be get user list (async)', async(() => {
    // call component.query();
    fixture.whenStable().then(() => {
        fixture.detectChanges();
        expect(true).toBe(true);
    });
}));

fakeAsync

如果說(shuō) async 還需要回調(diào)才能進(jìn)行斷點(diǎn)讓你受不了的話，那么 fakeAsync 可以解決這一點(diǎn)。

it('should be get user list (async)', fakeAsync(() => {
    // call component.query();
    tick();
    fixture.detectChanges();
    expect(true).toBe(true);
}));

這里只是將回調(diào)換成 tick()，怎么樣，是不是很酷。

Jasmine自帶異步

如前面所說(shuō)的異步是指帶有 Observable 或 Promise 的異步行為，而有時(shí)候我們有些東西是依賴 setTimeout 或者可能是需要外部訂閱結(jié)果以后才能觸發(fā)時(shí)怎么辦呢？

可以使用 done() 方法。

it('async demo', (done: () => void) => {
    context.show().subscribe(res => {
        expect(true).toBe(true);
        done();
    });
    el.querySelected('xxx').click();
});

四、結(jié)論

本章幾乎所有的內(nèi)容在Angular單元測(cè)試經(jīng)常使用到的東西；特別是異步部分，三種不同異步方式并非共存的，而是需要根據(jù)具體業(yè)務(wù)而采用。否則，你會(huì)發(fā)現(xiàn)真TM難寫單元測(cè)試。畢竟這是一個(gè)異步的世界。

自此，我們算是為Angular寫單元測(cè)試打下了基礎(chǔ)。后續(xù)，將不會(huì)再對(duì)這類基礎(chǔ)進(jìn)行解釋。

那么下一篇，我們將介紹Component、Directive、Pipe 以及Service單元測(cè)試。

happy coding!