上一篇談了 ng 的單元測試,這次換 e2e(end-to-end,端對端)測試。
分工其實很清楚:驗證單一模組的單點功能,單元測試最合適;但一旦 bug 出現在使用者跨多個頁面互動的路徑上,單元測試就無能為力了——它看不見頁面之間的關係。這時需要 e2e 來模擬使用者操作、重現問題現場。而且 e2e 能驗證的東西遠不只 bug:整體流程的健壯性、非同步時序、表單與路由的協同,很多單元測試碰不到的地方,它都能覆蓋。
早期 ng 靠 Angular Scenario Runner 跑 e2e,現在已改用 Protractor。
Protractor 是 AngularJS 生態的 e2e 測試框架,以 npm 模組形式發布,內部建構在 WebDriverJS 之上。它的特色是讓測試真正跑在瀏覽器裡,完整模擬使用者的真實行為,而不是只在 JS 層面打轉。
幾個值得收藏的資源:Protractor 的 API 文件、官方簡易範例,以及它所依賴的核心 selenium-webdriver 的 WebDriverJs 指南。
Protractor 跑 e2e 需要三個部分協同:
1. WebDriver APIs(即 WebDriverJS),Selenium 提供給前端測試用的 JS 介面。
2. Selenium Server,一個後端 jar 包,負責與瀏覽器驅動溝通。
3. WebDriver browser drivers,真正驅動瀏覽器、呈現真實頁面內容並與 Selenium Server 通訊——使用者的點擊、輸入都在這一層發生。
整體結構如下圖:

直接看真實例子最快。先抓種子專案:
git clone https://github.com/angular/angular-seed.git
然後安裝依賴:
npm install
e2e 的設定在 test/protractor-conf.js,幾個關鍵屬性:
1. specs:要執行的測試檔路徑,這裡是 e2e/*.js。
2. baseUrl:測試中瀏覽器跳轉頁面時用的根位址。
3. capabilities:指定用哪個瀏覽器跑,例如:
capabilities: {
'browserName': 'chrome'
}
4. framework:採用哪種測試框架,這裡是 jasmine。
官方範例:
'use strict';
/* https://github.com/angular/protractor/blob/master/docs/getting-started.md */
describe('my app', function() {
browser.get('index.html');
it('should automatically redirect to /view1 when location hash/fragment is empty', function() {
expect(browser.getLocationAbsUrl()).toMatch("/view1");
});
describe('view1', function() {
beforeEach(function() {
browser.get('index.html#/view1');
});
it('should render view1 when user navigates to /view1', function() {
expect(element.all(by.css('[ng-view] p')).first().getText()).
toMatch(/partial for view 1/);
});
});
describe('view2', function() {
beforeEach(function() {
browser.get('index.html#/view2');
});
it('should render view2 when user navigates to /view2', function() {
expect(element.all(by.css('[ng-view] p')).first().getText()).
toMatch(/partial for view 2/);
});
});
});
語法本身是 jasmine 的寫法。這裡只補充 protractor 提供的三個常用全域物件:
1. browser:代表當前瀏覽器實例,最常用的 get 方法用來改變網址。
2. element:類似 jQuery 的文件元素查詢功能,通常與 by 搭配。
3. by:選擇器類型,可用 css、model、binding 等多種條件定位元素。
先下載瀏覽器驅動與本地 Selenium Server:
npm run update-webdriver
老實說這步常常失敗,因為兩個資源都在 Google 的伺服器上。可行的作法是手動下載:
1. Chrome Driver,一般抓 chromedriver_2.9.zip。
2. selenium-server standalone jar,一般抓 selenium-server-standalone-2.40.0.jar。
然後把 selenium-server 的 jar 丟進 protractor 裡的 selenium 目錄(指令超時後該目錄也會存在,只是檔案是空的,直接覆蓋即可),再把 chromedriver zip 解壓後的檔案放進同一處。
最後執行:
npm run protractor
終端機就會印出測試結果。
ng 的 e2e 測試,設定階段確實比單元測試繁瑣不少——瀏覽器驅動、Selenium Server、版本相容性都是坑。但一旦跑通,它能覆蓋的範圍是單元測試給不了的。值得花時間試一次,有問題歡迎留言討論。