- 開発
READ MORE
原著者の許諾を得て翻訳・公開いたします。
RSpecを使って、指定のメソッドが呼び出される回数をexpect
で指定することができます。その方法を説明する前に、呼び出し回数を知ることの重要性についてお話します。これはコードの振る舞いを制御するためのものです。説明のため、わざと誤ったコードを書いてみます。
class SomeClass
def something
@something = service.call
end
end
これのどこが誤りかおわかりでしょうか。ここではメモ化によって、SomeClass#something
が呼ばれるたびにservice.call
が2回以上呼ばれることのないようにしたいと考えています。しかしメモ化の||=
演算子ではなく=
演算子が使われているため、期待どおりメモ化されていません。
このコードに対して次のようなテストを書くとします。
expect(some_class_instance).to have_received(:something)
このテストでは、メモ化が行われていないという誤りを検出できません。上のようなシンプルな例ならともかく、たとえばservice.call
が外部APIを呼び出していて、限りあるリソースを食いつぶしているとしたら非常に残念ことになります。これを回避するには、メソッド呼び出しが何回行われるべきかを指定します。
expect(some_class_instance).to have_received(:something).once
このexpectationを用いることで誤りが検出されます。しかしTDD(テスト駆動開発)アプローチではこのテストは決して作られることはないでしょう。このことから、TDDを用いるとともにexpectationを詳細に書くことの重要性がわかります。
コードが2回以上呼び出されたかどうかをテストしたい場合や、少なくとも2回または3回以上呼び出されたかどうかをテストしたい場合はどのように書けばよいでしょうか?RSpecの文法でこれらを指定することもできます。
n
回呼び出されるexpectation:expect(some_class_instance).to have_received(:something).once
expect(some_class_instance).to have_received(:something).twice
expect(some_class_instance).to have_received(:something).exactly(3).times
n
回以上呼び出されるexpectation:expect(some_class_instance).to have_received(:something).at_least(:once)
expect(some_class_instance).to have_received(:something).at_least(:twice)
expect(some_class_instance).to have_received(:something).at_last(3).times
n
回以下のexpectation:expect(some_class_instance).to have_received(:something).at_most(:once)
expect(some_class_instance).to have_received(:something).at_most(:twice)
expect(some_class_instance).to have_received(:something).at_most(3).times
もっと稼ぎたい方や会社をさらに発展させたい方へ: テスティングのスキルの重要性にお気づきでしょうか?テストを正しく書き始めることが、唯一のファーストステップです。無料でダウンロードいただける私の書籍『RSpec & Test Driven Developmentの無料ebook』をどうぞお役立てください。