JavaScriptのテストコードをNode.js＋Jasmineで実行してみよう

JavaScriptでテストを書こう！ 第3回

Jasmineでのテストの書き方と実行

　Jasmineを実行する準備ができましたので、Jasmineの基本的な書き方を説明します。

基本的な書き方

　Jasmineでテストを書いてみましょう。リスト05はJasmineでのテストの基本的な書き方です。まずは、describeメソッドを記述し、その説明を言葉で記述します。describeは、日本語で言うと「描写する」「言葉で説明する」という意味です。

　describeメソッドの第2引数である無名関数の中で実際のテストを記述します。テストはitメソッドごとに記述し、引数の無名関数の中で、expectメソッド（アサーションメソッド）を実行します。

リスト05：評価メソッドの例（spec/addition.spec.js）

var addition = function(number1, number2){
	return number1 + number2;
}

describe("足し算の確認", function() {
  it("足し算が正しい", function() {
    expect(addition(1, 2)).toEqual(3);
  });
});

　テストを実行する前処理、後処理を記述することもできます。beforeEachメソッドはテストの前処理、afterEachメソッドはテストの後処理を行います。それぞれ、itメソッドごとに実行されます。例えば、テストのためのテストデータをDBに入れるなどの処理を行う用途があります。

リスト06：評価メソッドの例（spec/addition.spec.js）

describe("足し算の確認", function() {
  beforeEach(function() {
    // テスト前処理
  });

  afterEach(function() {
    // テスト後処理
  });
  
  it("足し算が正しい", function() {
    expect(addition(1, 2)).toEqual(3);
  });
});

　その他にも、Ajaxのようなリクエストをサーバサイドの機能を用意しなくてもテストができるように置き換えるといった、スパイやモック機能も用意されています。

テストの実行

　テストを実行してみましょう。jasmine-nodeでは、テストを記述したファイルのファイル名は、「～spec.js」とする必要があります。CoffeeScriptで記述した場合は、「～spec.coffee」です。

　リスト05のファイルを「spec」というディレクトリの中に、「addition.spec.js」という名前で保存します。次に、そのファイルをコマンドラインから実行します。テストの実行結果が表示されます。

リスト07：テスト実行コマンド

jasmine-node spec\addition.spec.js

jasmine-nodeでのテスト実行結果

アサーションメソッド

　Jasmineには、処理結果などの値を評価するためのアサーションメソッドが用意されています。ここでは、代表的なものを紹介します。

同じである（toEqual、toBe）

　同じであることを評価するメソッドは、toEqualとtoBeメソッドがあります。toEqualはif文の「==」、toBeは「===」と同様の評価をします。toEqualは値が同じであることの評価、toBeは型も同じであることまで評価します。

リスト08：toEqual、toBe（spec/equal.spec.js）

var addition = function(number1, number2){
	return number1 + number2;
}

describe('同じである（toEqual、toBe）', function() {
  it("同じであることの確認：toEqual", function() {
    expect(addition(1, 2)).toEqual(3);
    expect(addition(1, 2)).not.toEqual(4);
  });
  it("同じであることの確認：toBe", function() {
    var testToBe1 = "test";
    var testToBe2 = testToBe1;
    var testToBe3 = "1";
    expect(testToBe2).toBe(testToBe1);
    expect(testToBe3).not.toBe(1);
  });
});

正規表現で評価（toMatch）

　正規表現にマッチングしているかどうかを評価することができます。JavaScriptのmatchメソッドと同様に記述できます。

リスト09：toMatch（spec/toMatch.spec.js）

describe('アサーションメソッド', function() {
  it("toMatch", function() {
    expect("13:45").toMatch(/^[0-9][0-9]:[0-9][0-9]$/);
    expect("2014/02/25").not.toMatch(/^[0-9][0-9]:[0-9][0-9]$/);
  });
});

その他のアサーションメソッド

　上記で紹介した内容も含め、アサーションメソッドの一覧は以下のとおりです。

アサーションメソッド一覧

メソッド	説明
expect(x).toEqual(y)	値が同じであること（==と同様）を評価
expect(x).toBe(y)	同じオブジェクトかどうか（===と同様）を評価
expect(x).toMatch(pattern)	xがpatternで指定した正規表現にマッチしているかを評価
expect(x).toBeDefined()	xに値が格納されているかを評価
expect(x).toBeUndefined()	xに値が格納されていないかを評価
expect(x).toBeNull()	xがnullかどうかを評価
expect(x).toBeTruthy()	xがtrueかどうかを評価
expect(x).toBeFalsy()	xがfalseかどうかを評価
expect(x).toContain(y)	配列や文字列xに、yが含まれているかどうかを評価
expect(x).toBeLessThan(y)	xがよりyが小さいかどうかを評価
expect(x).toBeGreaterThan(y)	xがよりyが大きいかどうかを評価
expect(function(){fn();}).toThrow(e);	function内でexceptionが発生するかどうかを評価