RSpec、具体的にはバージョン> = 3では、次の間に違いがあります:
allow
を使用してテストダブルを返すパラメーターでメッセージの期待値を設定し、次にexpect
を使用して返されたテストダブルでアサーションを作成します。expect
を使用して、パラメーターを使用して期待値を設定し、テストダブルを返します。それとも、すべて意味論ですか? expect
で戻り値を提供/指定することは RSpecモック2.13の構文 でしたが、私が見る限り RSpecモック3で変更された構文 を使用してallow
を使用します。
ただし、以下の(渡す)サンプルコードでは、allow
/expect
またはexpect
/_and_return
_のいずれかを使用しても同じ結果が生成されるようです。ある構文が別の構文よりも好まれた場合、おそらく何らかの非推奨通知があると予想していましたが、そうではないので、両方の構文が有効であると見なされるようです:
_class Foo
def self.bar(baz)
# not important what happens to baz parameter
# only important that it is passed in
new
end
def qux
# perform some action
end
end
class SomethingThatCallsFoo
def some_long_process(baz)
# do some processing
Foo.bar(baz).qux
# do other processing
end
end
describe SomethingThatCallsFoo do
let(:foo_caller) { SomethingThatCallsFoo.new }
describe '#some_long_process' do
let(:foobar_result) { double('foobar_result') }
let(:baz) { double('baz') }
context 'using allow/expect' do
before do
allow(Foo).to receive(:bar).with(baz).and_return(foobar_result)
end
it 'calls qux method on result of Foo.bar(baz)' do
expect(foobar_result).to receive(:qux)
foo_caller.some_long_process(baz)
end
end
context 'using expect/and_return' do
it 'calls qux method on result of Foo.bar(baz)' do
expect(Foo).to receive(:bar).with(baz).and_return(foobar_result)
expect(foobar_result).to receive(:qux)
foo_caller.some_long_process(baz)
end
end
end
end
_
渡されたbaz
パラメーターを別のテストダブルに変更して意図的にテストを失敗させた場合、エラーはほとんど同じです。
_ 1) SomethingThatCallsFoo#some_long_process using allow/expect calls quux method on result of Foo.bar(baz)
Failure/Error: Foo.bar(baz).qux
<Foo (class)> received :bar with unexpected arguments
expected: (#<RSpec::Mocks::Double:0x3fe97a0127fc @name="baz">)
got: (#<RSpec::Mocks::Double:0x3fe97998540c @name=nil>)
Please stub a default value first if message might be received with other args as well.
# ./foo_test.rb:16:in `some_long_process'
# ./foo_test.rb:35:in `block (4 levels) in <top (required)>'
2) SomethingThatCallsFoo#some_long_process using expect/and_return calls quux method on result of Foo.bar(baz)
Failure/Error: Foo.bar(baz).qux
<Foo (class)> received :bar with unexpected arguments
expected: (#<RSpec::Mocks::Double:0x3fe979935fd8 @name="baz">)
got: (#<RSpec::Mocks::Double:0x3fe979cc5c0c @name=nil>)
# ./foo_test.rb:16:in `some_long_process'
# ./foo_test.rb:43:in `block (4 levels) in <top (required)>'
_
それで、結果または表現された意図のいずれかで、これらの2つのテスト間に実際の違いはありますか、それとも単にセマンティクスおよび/または個人的な好みですか? allow
/expect
は一般的にexpect
/_and_return
_を介して使用する必要があります。これは置換構文のように見えるか、またはそれぞれで特定のテストシナリオ?
更新
森の答え を読んだ後、上記のサンプルコードからFoo.bar(baz).qux
行をコメントアウトし、次のエラーを受け取りました。
_ 1) SomethingThatCallsFoo#some_long_process using allow/expect calls qux method on result of Foo.bar(baz)
Failure/Error: expect(foobar_result).to receive(:qux)
(Double "foobar_result").qux(any args)
expected: 1 time with any arguments
received: 0 times with any arguments
# ./foo_test.rb:34:in `block (4 levels) in <top (required)>'
2) SomethingThatCallsFoo#some_long_process using expect/and_return calls qux method on result of Foo.bar(baz)
Failure/Error: expect(Foo).to receive(:bar).with(baz).and_return(foobar_result)
(<Foo (class)>).bar(#<RSpec::Mocks::Double:0x3fc211944fa4 @name="baz">)
expected: 1 time with arguments: (#<RSpec::Mocks::Double:0x3fc211944fa4 @name="baz">)
received: 0 times
# ./foo_test.rb:41:in `block (4 levels) in <top (required)>'
_
foobar_result
_ doubleはFoo.bar(baz)
の結果に代わらないため、_#qux
_が呼び出されることはないため、allow
仕様は失敗します。expect
仕様はFoo
が.bar(baz)
を受け取らない点で失敗するので、_foobar_result
_ doubleを問い合わせる点にさえ到達しません理にかなっています:構文の変更だけではなく、expect
/_and_return
_にはallow
/expect
とは異なる目的があります。 RSpec Mocks README の最も明白な場所、特に以下のセクションを確認する必要がありました。
従来の記事 Mocks Are n't Stubs を参照してください。 allow
はスタブを作成し、expect
はモックを作成します。つまり、allow
は、オブジェクトがスタブなしで返すものの代わりにXを返すことを許可し、expect
はallow
plus何らかの状態またはイベントの期待です。書くとき
_allow(Foo).to receive(:bar).with(baz).and_return(foobar_result)
_
... Foo
で_foobar_result
_を受け取ったときに_:bar
_を返すようにbaz
を変更するように仕様環境に指示しています。しかし、あなたが書くとき
_expect(Foo).to receive(:bar).with(baz).and_return(foobar_result)
_
...同じことをしていることに加えて、仕様に失敗するように指示しますnlessFoo
はbaz
で_:bar
_を受け取ります。
違いを確認するには、Foo
がnot receive _:bar
_ with baz
を行う例で両方を試してください。