node.jsのソースを単体テストする際のmocha+sinonの使い方
node.jsのソースをmochaでテストしているとsinonでモックしてテストする、といったケースがあると思います。
sinonは英語ドキュメントもありますし、広く使われているモジュールなのでモックの方法がネットにごろごろ転がっています。
sinonでメソッドをモックする
簡単なソースでsinonを試してみたいと思います。
以下をindex.jsで保存します。
|
1 2 3 4 5 |
function testMethod(money=0){ money = money * 1.08; return money; }; exports.sample = testMethod; |
exports.sampleという変数にtestMethodを代入します。これでtestMethodをsampleという名前で他のモジュールからも使えるようにします。
このtestMethodの戻り値をsinonでモックしてみます。
以下、index.test.jsです。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
const chai = require('chai'); const sinon = require('sinon'); const assert = chai.assert; const expect = chai.expect; const target = require('../../main/sample001/index.js');// requireする describe('sinon', function () { it('sinonのテスト', function(){ let stub = sinon.stub(target,'sample');// targetのsampleをスタブする let expected = 110; stub.returns(expected);// sampleの戻り値は110にしてみる let ret = target.sample(50); console.log(ret); expect(expected).to.equal(ret); }); }); |
stub.returnsで戻り値を指定しているので、これでモックができたことになります。
そのあとにsample()を実行すると引数が何であっても戻り値は指定した戻り値となります。
結果は以下のようになります。
sinonでメソッド内のメソッドをモックする
実際はメソッド内にあるDBに検索するメソッドなどをモックするというケースが多いかと思います。
以下はメソッド内のメソッドをモックする例です。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
function testMethod(money=0){ let self = this; money = money * self.getTax();// 消費税を別のメソッドから取得 return money; }; function getTax() { return 1.08;// DBから取得しているイメージで、、 } module.exports = { sample: testMethod, getTax: getTax }; |
getTaxは通常はDBから取得すると思いますが、モックできるかのテストなので1.08を返すだけにしました。
index.test.jsで1.08を返すのをスタブ化し、1.10を返すようにしています。テスト自体はtestMethodメソッドから実行しています。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
const chai = require('chai'); const sinon = require('sinon'); const assert = chai.assert; const expect = chai.expect; const target = require('../../main/sample001/index.js'); describe('sinon', function () { it('sinonのテスト', function(){ let stub = sinon.stub(target,'getTax');// スタブする let val = 1.10; stub.returns(val);// getTaxメソッドの戻り値は1.10 let ret = target.sample(100);// インプットは100 let expected = 110;// 期待値は110 expect(expected).to.equal(parseInt(ret)); }); }); |
sandboxでオブジェクトのキーに対するプロパティをモックする
sinon.sandbox.create()メソッドでsandboxオブジェクトを返します。
※sandbox.create() is deprecated （非推奨となっています）
変わりにrequire('sinon').createSandbox()メソッドを使用します。
|
1 |
sandbox.stub(オブジェクト,'キー').values('モックしたい値') |
このように記述するとオブジェクトのキーに対するプロパティをモックすることができます。
以下、実行例です。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
const chai = require('chai'); const sinon = require('sinon') const sandbox = require('sinon').createSandbox() const assert = chai.assert; const expect = chai.expect; describe('sinon', function () { it('sinonのテスト', function(){ const myObject = { 'hello': 'world' }; sandbox.stub(myObject, 'hello').value('Sinon'); // valueの代わりにreturnsも可 let expected = 'Sinon'; expect(expected).to.equal(myObject.hello); }); afterEach(() => { sandbox.restore() }) after(() => { sinon.restore() }) }); |
結果は成功します。
sandbox.stubでPromiseの結果をモックする
sinonのエラー
Cannot stub non-existent own property XXX
…XXXというメソッドがない場合にこのエラーが発生する。
TypeError: Attempted to wrap execute which is already wrapped
…すでにモックしているものをもう一度モックしようとすると発生する。
sinonの評価はmocha+chaiの使い方を参照して下さい。
process.env（環境変数）をモックする方法
process.env（環境変数）をモックするにはsandboxを使用します。
createSandboxメソッドでsandboxを作成し、afterEachでサンドボックスのrestoreします。
afterでsinonのリストアをします。
| const sinon = require('sinon') // sinon作成 | |
| const sandbox = require('sinon').createSandbox() //sandbox作成 | |
| afterEach(()=>{ | |
| sandbox.restore()// sandboxをリストアすること | |
| }) | |
| after(()=>{ | |
| sinon.restore() // sinonをリストアすること | |
| }) |
|
1 |
sandbox.stub(process.env, 'PATH').value('12345');// 環境変数PATHを12345にモック |
上記で環境変数PATHの値を変えることができます。但し、環境変数がPCに設定されていない場合は以下のようなエラーとなります。
|
1 |
TypeError: Cannot stub non-existent own property PATH |
以下、実行例です。
| const chai = require('chai') | |
| const sinon = require('sinon') | |
| const sandbox = sinon.createSandbox() | |
| const expect = chai.expect | |
| describe('sinon', function () { | |
| it('sinonのテスト', function(){ | |
| sandbox.stub(process.env, 'PATH').value('12345') | |
| expect(process.env.PATH).to.equal('12345') // passになる | |
| }) | |
| afterEach(function () { | |
| sandbox.restore() | |
| }); | |
| after(function () { | |
| sinon.restore() | |
| }) | |
| }) |
オブジェクトをモックする
sinon.stubメソッドは第一引数でオブジェクトだけを指定することができます。
|
1 |
sinon.stub(target); |
この場合、targetが持つすべてのメソッドをモックすることになります。
targetはaaa,bbb,cccと言うメソッドを持つとします。その場合、以下のように全てのメソッドをrestore()する必要があります。
|
1 2 3 4 5 6 7 8 9 |
beforeEach(function (done) { stub = sinon.stub(target);// 第二引数でメソッドは指定しない done(); }); afterEach(function (done) { stub.aaa.restore(); stub.bbb.restore(); stub.ccc.restore(); } |
メソッドの戻り値を動的に変更する
メソッドをモックすることができますが、1回目の戻り値と2回目の戻り値を変更したい場合があります。
以下のようにonCallメソッドを使用します。
|
1 2 3 |
const stub = sinon.stub(target.service, 'getDb'); stub.onCall(0).returns(Promise.resolve('1'));// 1回目は1を返す stub.onCall(1).returns(Promise.resolve('2'));// 2回目は2を返す |
onCall(0)が1回目の戻り値になります。
onCall(1)が2回目の戻り値になります。
sinonのアサーション
sinonには標準でアサーションが用意されています。
| sinon.assert.called(index.tax) // 呼ばれたことの検証 | |
| sinon.assert.calledOnce(index.tax) // 1回呼ばれたことの検証 | |
| sinon.assert.notCalled(index.tax) // 呼ばれていないことの検証 | |
| sinon.assert.calledTwice(index.tax) // 2回呼ばれたことの検証 | |
| sinon.assert.callOrder(index.tax, index.age) // スタブしたメソッドの呼ばれた順序の検証 | |
| sinon.assert.callCount(index.tax, 3) // スタブしたメソッドの呼ばれた回数の検証 |
KHI入社して退社。今はCONFRAGEで正社員です。関西で140-170/80～120万から受け付けております^^
得意技はJS(ES6),Java,AWSの大体のリソースです
コメントはやさしくお願いいたします^^
座右の銘は、「狭き門より入れ」「願わくは、我に七難八苦を与えたまえ」です^^
