天天看點

Karma和Jasmine自動化單元測試1. Karma的介紹2. Karma的安裝3. Karma + Jasmine配置4. 自動化單元測試5. Karma和istanbul代碼覆寫率6. Karma第一次啟動時出現的問題

前言

在Java領域,Apache, Spring, JBoss 三大社群的開源庫,包羅萬象,但每個庫都在其領域中都鶴立雞群。而Nodejs中各種各樣的開源庫,卻讓人眼花缭亂,不知從何下手。

Nodejs領域: Jasmine做單元測試,Karma自動化完成單元測試,Grunt啟動Karma統一項目管理,Yeoman最後封裝成一個項目原型模闆,npm做nodejs的包依賴管理,bower做javascript的包依賴管理。Java領域:JUnit做單元測試, Maven自動化單元測試,統一項目管理,建構項目原型模闆,包依賴管理。

Nodejs讓組合變得更豐富,卻又在加重我們的學習門檻。我還說不清楚,也看不透!

上面寫的有點遠了,回到文章的主題,Jasmine+Karma自動化單元測試。

目錄

  1. Karma的介紹
  2. Karma的安裝
  3. Karma + Jasmine配置
  4. 自動化單元測試
  5. Karma和istanbul代碼覆寫率
  6. Karma第一次啟動時出現的問題

1. Karma的介紹

Karma是Testacular的新名字,在2012年google開源了Testacular,2013年Testacular改名為Karma。Karma是一個讓人感到非常神秘的名字,表示佛教中的緣分,因果報應,比Cassandra這種名字更讓人猜不透!

Karma是一個基于Node.js的JavaScript測試執行過程管理工具(Test Runner)。該工具可用于測試所有主流Web浏覽器,也可內建到CI(Continuous integration)工具,也可和其他代碼編輯器一起使用。這個測試工具的一個強大特性就是,它可以監控(Watch)檔案的變化,然後自行執行,通過console.log顯示測試結果。

Jasmine是單元測試架構,本單将介紹用Karma讓Jasmine測試自動化完成。Jasmine的介紹,請參考文章:jasmine行為驅動,測試先行

istanbul是一個單元測試代碼覆寫率檢查工具,可以很直覺地告訴我們,單元測試對代碼的控制程度。

2. Karma的安裝

系統環境:

win7 64bit, node v0.10.5, npm 1.2.19
           

安裝Karma

~ D:\workspace\javascript>mkdir karma
~ D:\workspace\javascript>cd karma
~ D:\workspace\javascript\karma>npm install -g karma

# 測試是否安裝成功
~ D:\workspace\javascript\karma>karma start
INFO [karma]: Karma v0.10.2 server started at http://localhost:9876/
INFO [Chrome 28.0.1500 (Windows 7)]: Connected on socket nIlM1yUy6ELMp5ZTN9Ek
           

從浏覽器看到karam界面。

Karma和Jasmine自動化單元測試1. Karma的介紹2. Karma的安裝3. Karma + Jasmine配置4. 自動化單元測試5. Karma和istanbul代碼覆寫率6. Karma第一次啟動時出現的問題

下面我們要開始配置karam。

3. Karma + Jasmine配置

初始化karma配置檔案karma.conf.js

~ D:\workspace\javascript\karma>karma init

Which testing framework do you want to use ?
Press tab to list possible options. Enter to move to the next question.
> jasmine

Do you want to use Require.js ?
This will add Require.js plugin.
Press tab to list possible options. Enter to move to the next question.
> no

Do you want to capture a browser automatically ?
Press tab to list possible options. Enter empty string to move to the next question.
> Chrome
>

What is the location of your source and test files ?
You can use glob patterns, eg. "js/*.js" or "test/**/*Spec.js".
Enter empty string to move to the next question.
>

Should any of the files included by the previous patterns be excluded ?
You can use glob patterns, eg. "**/*.swp".
Enter empty string to move to the next question.
>

Do you want Karma to watch all the files and run the tests on change ?
Press tab to list possible options.
> yes

Config file generated at "D:\workspace\javascript\karma\karma.conf.js".
           

安裝內建包karma-jasmine

~ D:\workspace\javascript\karma>npm install karma-jasmine
           

4. 自動化單元測試

3步準備工作:

  • 1. 建立源檔案:用于實作某種業務邏輯的檔案,就是我們平時寫的js腳本
  • 2. 建立測試檔案:符合jasmineAPI的測試js腳本
  • 3. 修改karma.conf.js配置檔案

1). 建立源檔案:用于實作某種業務邏輯的檔案,就是我們平時寫的js腳本

有一個需求,要實作單詞倒寫的功能。如:”ABCD” ==> “DCBA”

~ vi src.js

function reverse(name){
    return name.split("").reverse().join("");
}
           

2). 建立測試檔案:符合jasmineAPI的測試js腳本

describe("A suite of basic functions", function() {
    it("reverse word",function(){
        expect("DCBA").toEqual(reverse("ABCD"));
    });
});
           

3). 修改karma.conf.js配置檔案

我們這裡需要修改:files和exclude變量

module.exports = function (config) {
    config.set({
        basePath: '',
        frameworks: ['jasmine'],
        files: ['*.js'],
        exclude: ['karma.conf.js'],
        reporters: ['progress'],
        port: 9876,
        colors: true,
        logLevel: config.LOG_INFO,
        autoWatch: true,
        browsers: ['Chrome'],
        captureTimeout: 60000,
        singleRun: false
    });
};
           

啟動karma

單元測試全自動執行

~ D:\workspace\javascript\karma>karma start karma.conf.js
INFO [karma]: Karma v0.10.2 server started at http://localhost:9876/
INFO [launcher]: Starting browser Chrome
WARN [launcher]: The path should not be quoted.
  Normalized the path to C:\Program Files (x86)\Google\Chrome\Application\chrome.exe
INFO [Chrome 28.0.1500 (Windows 7)]: Connected on socket bVGffDWpc1c7QNdYye_6
INFO [Chrome 28.0.1500 (Windows 7)]: Connected on socket DtTdVbd4ZsgnMQrgye_7
Chrome 28.0.1500 (Windows 7): Executed 1 of 1 SUCCESS (3.473 secs / 0.431 secs)
Chrome 28.0.1500 (Windows 7): Executed 1 of 1 SUCCESS (0.068 secs / 0.021 secs)
TOTAL: 2 SUCCESS
           

浏覽器會自動打開

Karma和Jasmine自動化單元測試1. Karma的介紹2. Karma的安裝3. Karma + Jasmine配置4. 自動化單元測試5. Karma和istanbul代碼覆寫率6. Karma第一次啟動時出現的問題

我們修改test.js

~ vi test.js

describe("A suite of basic functions", function() {
    it("reverse word",function(){
        expect("DCBA").toEqual(reverse("ABCD"));
        expect("Conan").toEqual(reverse("nano"));
    });
});
           

由于karma.conf.js配置檔案中autoWatch: true, 是以test.js檔案儲存後,會自動執行單元測試。

執行日志如下:提示我們單元測試出錯了。

INFO [watcher]: Changed file "D:/workspace/javascript/karma/test.js".
Chrome 28.0.1500 (Windows 7) A suite of basic functions reverse word FAILED
        Expected 'Conan' to equal 'onan'.
        Error: Expected 'Conan' to equal 'onan'.
            at null. (D:/workspace/javascript/karma/test.js:4:25)
Chrome 28.0.1500 (Windows 7): Executed 1 of 1 (1 FAILED) ERROR (0.3 secs / 0.006 secs)
           

5. Karma和istanbul代碼覆寫率

增加代碼覆寫率檢查和報告,增加istanbul依賴

~ D:\workspace\javascript\karma>npm install karma-coverage
           

修改karma.conf.js配置檔案

~ vi karma.conf.js

reporters: ['progress','coverage'],
preprocessors : {'src.js': 'coverage'},
coverageReporter: {
    type : 'html',
    dir : 'coverage/'
}
           

啟動karma start,在工程目錄下面找到index.html檔案,coverage/chrome/index.html

打開後,我們看到代碼測試覆寫綠報告

Karma和Jasmine自動化單元測試1. Karma的介紹2. Karma的安裝3. Karma + Jasmine配置4. 自動化單元測試5. Karma和istanbul代碼覆寫率6. Karma第一次啟動時出現的問題

覆寫率是100%,說明我們完整了測試了src.js的功能。

接下來,我們修改src.js,增加一個if分支

function reverse(name){
    if(name=='AAA') return "BBB";
    return name.split("").reverse().join("");
}
           

再看覆寫率報告,

Karma和Jasmine自動化單元測試1. Karma的介紹2. Karma的安裝3. Karma + Jasmine配置4. 自動化單元測試5. Karma和istanbul代碼覆寫率6. Karma第一次啟動時出現的問題

Statements:75%覆寫,Branches:50%覆寫。

為了産品的品質我們要盡量達到更多的覆寫率,一般對于JAVA項目來說,能達到80%就是相當高的标準了。對于Javascript的代碼測試及覆寫率研究,我還要做更多的驗證。

6. Karma第一次啟動時出現的問題

CHROME_BIN的環境變量問題

~ D:\workspace\javascript\karma>karma start karma.conf.js
INFO [karma]: Karma v0.10.2 server started at http://localhost:9876/
INFO [launcher]: Starting browser Chrome
ERROR [launcher]: Cannot start Chrome
        Can not find the binary C:\Users\Administrator\AppData\Local\Google\Chrome\Application\chrome.exe
        Please set env variable CHROME_BIN
           

設定方法:找到系統中chrome的安裝位置,找到chrome.exe檔案

~ D:\workspace\javascript\karma>set CHROME_BIN="C:\Program Files (x86)\Google\Chrome\Application\chrome.exe"
           

原文位址:

http://blog.fens.me/nodejs-karma-jasmine/

繼續閱讀