單元測試

Jasmine是一個用於測試JavaScript的行為驅動開發框架，不依賴於任何其他JavaScript框架。
Karma是測試運行器，為開發人員提供了高效的、真實的測試環境，支持多種瀏覽器，易於調試。

配置文件

單元測試配置文件test.ts和karma.conf.js：
test.ts

import ‘zone.js/dist/zone-testing‘;
import { getTestBed } from ‘@angular/core/testing‘;
import {
  BrowserDynamicTestingModule,
  platformBrowserDynamicTesting
} from ‘@angular/platform-browser-dynamic/testing‘;

declare const require: any;

// First, initialize the Angular testing environment.
getTestBed().initTestEnvironment(
  BrowserDynamicTestingModule,
  platformBrowserDynamicTesting()
);
// Then we find all the tests.
const context = require.context(‘./‘, true, /\.spec\.ts$/);
// And load the modules.
context.keys().map(context);
 

測試文件擴展名必須為.spec.ts。
karma.conf.js

module.exports = function (config) {
  config.set({
    basePath: ‘‘,
    frameworks: [‘jasmine‘, ‘@angular-devkit/build-angular‘],
    plugins: [
      require(‘karma-jasmine‘),
      require(‘karma-chrome-launcher‘),
      require(‘karma-jasmine-html-reporter‘),
      require(‘karma-coverage-istanbul-reporter‘),
      require(‘@angular-devkit/build-angular/plugins/karma‘)
    ],
    client: {
      clearContext: false // leave Jasmine Spec Runner output visible in browser
    },
    coverageIstanbulReporter: {
      dir: require(‘path‘).join(__dirname, ‘../coverage‘),
      reports: [‘html‘, ‘lcovonly‘],
      fixWebpackSourcePaths: true
    },
    reporters: [‘progress‘, ‘kjhtml‘],
    port: 9876,
    colors: true,
    logLevel: config.LOG_INFO,
    autoWatch: true,
    browsers: [‘Chrome‘],
    singleRun: false
  });
};
 

默認使用Chrome瀏覽器，可生成單元測試報告和覆蓋率報告，覆蓋率報告保存在根目錄coverage文件夾內，啟用autoWatch。
singleRun默認為false，如設為true則測試結束後會自動退出並根據測試結果返回代碼0或1，常用於CI環境。

瀏覽器配置

Karma支持的瀏覽器：

• Chrome
• ChromeCanary
• ChromeHeadless
• PhantomJS
• Firefox
• Opera
• IE
• Safari

可同時配置多個瀏覽器進行測試，要啟用其他瀏覽器，需安裝依賴，比如啟用Firefox：

npm install karma-firefox-launcher --save-dev
 

然後在karma.conf.js內增加配置：

...
require(‘karma-chrome-launcher‘),
require(‘karma-firefox-launcher‘),
...
browsers: [‘Chrome‘, ‘Firefox‘],
...

運行測試

使用CLI創建App生成了一個單元測試文件app.component.spec.ts。運行CLI命令 ng test 即可執行單元測試：

ng test

在控制臺會輸出測試結果，還會打開瀏覽器：

瀏覽器會顯示測試結果，總測試數，失敗數。在頂部，每個點或叉對應一個測試用例，點表示成功，叉表示失敗，鼠標移到點或叉上會顯示測試信息。點擊測試結果中的某一行，可重新運行某個或某組（測試套件）測試。

常用參數：
--browsers 指定使用的瀏覽器
--code-coverage 輸出覆蓋率報告
--code-coverage-exclude 排除文件或路徑
--karma-config 指定Karma配置文件
--prod 啟用production環境
--progress 默認為true，在構建時將進度輸出到控制臺
--watch 默認為true，代碼修改後會重新運行測試

自定義Launcher

karma-chrome-launcher、karma-firefox-launcher、karma-ie-launcher等均支持自定義Launcher，customLaunchers與--browsers結合使用可滿足多種環境的測試需求。每種瀏覽器支持的自定義屬性請查看Karma Browsers文檔。
比如，CI環境下常用Headless模式，不必使用瀏覽器界面，karma.conf.js增加如下配置：

browsers: [‘Chrome‘],
customLaunchers: {
  ChromeHeadlessCI: {
    base: ‘ChromeHeadless‘,
    flags: [‘--no-sandbox‘]
  }
},

運行如下命令進行測試：

ng test --watch=false --progress=false --browsers=ChromeHeadlessCI

測試覆蓋率

運行如下命令生成測試覆蓋率報告，報告保存在項目根目錄下的coverage文件夾內：

ng test --watch=false --code-coverage

如想每次測試都生成報告，可修改CLI配置文件angular.json：

"test": {
  "options": {
    "codeCoverage": true
  }
}

設置排除的文件或路徑

ng test --watch=false --code-coverage --code-coverage-exclude=src/app/heroes/heroes.component.ts --code-coverage-exclude=src/app/hero-search/*

同樣可以在angular.json中配置：

"test": {
  "options": {
    "codeCoverage": true,
    "codeCoverageExclude": ["src/app/heroes/heroes.component.ts", "src/app/hero-search/*"]
  }
}

設定測試覆蓋率指標
編輯配置文件karma.conf.js，增加如下內容：

coverageIstanbulReporter: {
  reports: [ ‘html‘, ‘lcovonly‘ ],
  fixWebpackSourcePaths: true,
  thresholds: {
    statements: 80,
    lines: 80,
    branches: 80,
    functions: 80
  }
}

測試報告中達到標準的背景為綠色。

LCOV
coverageIstanbulReporter中reports參數為[ ‘html‘, ‘lcovonly‘ ]，會生成html和lcov兩種格式的報告。報告文件lcov.info可與Sonar集成，在Sonar管理界面配置LCOV Files路徑，即可在Sonar中查看測試情況。

編寫測試

待續...

集成測試

集成測試使用Jasmine和Protractor測試框架，Protractor是Angular端到端測試框架。

安裝Protractor

npm install -g protractor

在項目中執行npm install時會安裝protractor，不必單獨執行以上命令。安裝protractor後會安裝兩個命令行工具protractor和webdriver-manager（位於node_modules\protractor\bin目錄），webdriver-manager負責管理驅動、啟停Selenium Server。

webdriver-manager命令：

clean      removes all downloaded driver files from the out_dir
start      start up the selenium server
shutdown   shut down the selenium server
status     list the current available drivers
update     install or update selected binaries，更新的驅動保存在node_modules\protractor\node_modules\webdriver-manager\selenium目錄下。
version    get the current version

配置文件

使用CLI創建的App會生成一個e2e項目，其中包含測試配置protractor.conf.js及測試代碼。
protractor.conf.js

const { SpecReporter } = require(‘jasmine-spec-reporter‘);

exports.config = {
  allScriptsTimeout: 11000,
  specs: [
    ‘./src/**/*.e2e-spec.ts‘
  ],
  capabilities: {
    ‘browserName‘: ‘chrome‘
  },
  directConnect: true,
  baseUrl: ‘http://localhost:4200/‘,
  framework: ‘jasmine‘,
  jasmineNodeOpts: {
    showColors: true,
    defaultTimeoutInterval: 30000,
    print: function() {}
  },
  onPrepare() {
    require(‘ts-node‘).register({
      project: require(‘path‘).join(__dirname, ‘./tsconfig.e2e.json‘)
    });
    jasmine.getEnv().addReporter(new SpecReporter({ spec: { displayStacktrace: true } }));
  }
};

默認，Protractor使用Jasmine測試框架，使用直連方式連接Chrome瀏覽器，測試文件擴展名為.e2e-spec.ts。

瀏覽器配置

Protractor支持Chrome、Firefox、Safari、IE等瀏覽器。
多瀏覽器
Protractor可同時啟動多個瀏覽器，用一個瀏覽器時，在配置中使用capabilities選項；用多個瀏覽器時，使用multiCapabilities：

multiCapabilities: [{
  browserName: ‘firefox‘
}, {
  browserName: ‘chrome‘
}]

另外需在package.json中增加配置：

"scripts": {
  "webdriver-update": "webdriver-manager update"
}

在運行測試前執行：

npm run webdriver-update

否則項目中的驅動不會更新（默認只有chrome驅動，在命令行運行webdriver-manager update僅更新全局的驅動），運行測試會報如下錯誤：

No update-config.json found. Run ‘webdriver-manager update‘ to download binaries

瀏覽器選項

capabilities: {
  ‘browserName‘: ‘chrome‘,
  ‘chromeOptions‘: {
    ‘args‘: [‘show-fps-counter=true‘]
  }
},

capabilities: {
  ‘browserName‘: ‘firefox‘,
  ‘moz:firefoxOptions‘: {
    ‘args‘: [‘--safe-mode‘]
  }
},

更多選項請查看相應驅動ChromeDriver、GeckoDriver。

Selenium Server配置

使用Standalone Selenium Server時，需安裝JDK。
更新driver後啟動Selenium Server：

webdriver-manager update
webdriver-manager start

刪除原配置中的directConnect、baseUrl：

directConnect: true,
baseUrl: ‘http://localhost:4200/‘,

增加seleniumAddress(默認為http://localhost:4444/wd/hub)：

seleniumAddress: ‘http://localhost:4444/wd/hub‘,

運行測試

執行CLI命令 ng e2e即可運行集成測試：

ng e2e

常用參數：

--base-url  Base URL for protractor to connect to.
--configuration (-c)  A named configuration environment, as specified in the "configurations" section of angular.json.
--host  Host to listen on.
--port  The port to use to serve the application.
--prod  When true, sets the build configuration to the production environment.
--protractor-config  The name of the Protractor configuration file.
--webdriver-update  Try to update webdriver.

指定配置文件

不同的環境若配置不同，可使用不同的配置文件。

比如，在CI環境中啟用Chrome Headless模式：
在e2e根目錄下創建一名為protractor-ci.conf.js的新文件，內容如下：

const config = require(‘./protractor.conf‘).config;

config.capabilities = {
  browserName: ‘chrome‘,
  chromeOptions: {
    args: [‘--headless‘, ‘--no-sandbox‘]
  }
};

exports.config = config;

註意： windows系統要增加參數--disable-gpu

運行以下命令測試：

ng e2e --protractor-config=e2e\protractor-ci.conf.js

編寫測試

待續...

參考資料

Jasmine Behavior-Driven JavaScript
Karma
Protractor - end-to-end testing for Angular

Angular單元測試與集成測試