node.jsのソースをmochaでテストしていると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)); }); }); |
オブジェクトのキーに対するプロパティをモックする
sinon.sandbox.create()メソッドでsandboxオブジェクトを返します。
|
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 assert = chai.assert; const expect = chai.expect; describe('sinon', function () { let sandbox; beforeEach(function () { sandbox = sinon.sandbox.create(); }); it('sinonのテスト', function(){ const myObject = { 'hello': 'world' }; sandbox.stub(myObject, 'hello').value('Sinon'); let expected = 'Sinon'; expect(expected).to.equal(myObject.hello); }); afterEach(function () { sandbox.restore();// リストアすること }); }); |
結果は成功します。
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を使用します。
beforeEachでsandboxを作成し、afterEachでrestoreします。
|
1 |
sandbox.stub(process.env, 'PATH').value('12345');// 環境変数PATHを12345にモック |
上記で環境変数PATHの値を変えることができます。但し、環境変数がPCに設定されていない場合は以下のようなエラーとなります。
|
1 |
TypeError: Cannot stub non-existent own property PATH |
以下、実行例です。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
const chai = require('chai'); const sinon = require('sinon'); const expect = chai.expect; describe('sinon', function () { let sandbox; beforeEach(function () { sandbox = sinon.sandbox.create(); }); it('sinonのテスト', function(){ sandbox.stub(process.env, 'PATH').value('12345'); expect(process.env.PATH).to.equal('12345');// passになる }); afterEach(function () { sandbox.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回目の戻り値になります。
関西で140-170/80～120万から受け付けております^^
得意技はJS(ES6),Java,AWSの大体のリソースです
Python3.6,Djangoを勉強中です,Javaは少し飽きてしまってます–;
コメントはやさしくお願いいたします^^
座右の銘は、「狭き門より入れ」「願わくは、我に七難八苦を与えたまえ」です^^
