私はこのようなことをしたいです:
some_method.should_raise <any kind of exception, I don't care>
どうすればいいですか?
some_method.should_raise exception
...動作しません。
expect { some_method }.to raise_error
RSpec 1構文:
lambda { some_method }.should raise_error
ドキュメント (RSpec 1構文の場合)および RSpec 2ドキュメント を参照してください。
expect { some_method }.to raise_error
expect { some_method }.to raise_error(SomeError)
expect { some_method }.to raise_error("oops")
expect { some_method }.to raise_error(/oops/)
expect { some_method }.to raise_error(SomeError, "oops")
expect { some_method }.to raise_error(SomeError, /oops/)
expect { some_method }.to raise_error(...){|e| expect(e.data).to eq "oops" }
# Rspec also offers to_not:
expect { some_method }.to_not raise_error
...
注:raise_error
とraise_exception
は交換可能です。
lambda { some_method }.should raise_error
lambda { some_method }.should raise_error(SomeError)
lambda { some_method }.should raise_error(SomeError, "oops")
lambda { some_method }.should raise_error(SomeError, /oops/)
lambda { some_method }.should raise_error(...){|e| e.data.should == "oops" }
# Rspec also offers should_not:
lambda { some_method }.should_not raise_error
...
注:raise_error
はraise_exception
のエイリアスです。
RSpec 2:
RSpec 1:
ラムダの代わりに、expectを使用して:
expect { some_method }.to raise_error
これは、rspecのより新しいバージョン、つまりrspec 2.0以降に適用されます。
詳しくは doco をご覧ください。
構文は最近変更され、現在は次のとおりです。
expect { ... }.to raise_error(ErrorClass)
バージョン3.3以降のrspec-expections
gemでは、パラメーターなしの空のraise_errorに対して警告が発生します
expect { raise StandardError }.to raise_error # results in warning
expect { raise StandardError }.to raise_error(StandardError) # fine
これにより、チェック対象のテストとは異なるエラーでコードが失敗する可能性があるというヒントが得られます。
警告:Rubyが
NoMethodError
、NameError
を発生させるとraise_error
が一致するため、特定のエラーまたはメッセージを提供せずにraise_error
マッチャーを使用すると誤検知のリスクがあります。またはArgumentError
を使用すると、呼び出しようとしているメソッドを実行することなく、期待どおりの結果が得られる可能性があります。代わりに、特定のエラークラスまたはメッセージを提供することを検討してください。このメッセージは、RSpec::Expectations.configuration.warn_about_potential_false_positives = false
を設定することで抑制できます。