Method: RSpec::Matchers#raise_error

Defined in:
lib/rspec/matchers/raise_error.rb

#raise_error(error = Exception, message = nil, &block) ⇒ Object Also known as: raise_exception

:call-seq:

should raise_error()
should raise_error(NamedError)
should raise_error(NamedError, String)
should raise_error(NamedError, Regexp)
should raise_error() { |error| ... }
should raise_error(NamedError) { |error| ... }
should raise_error(NamedError, String) { |error| ... }
should raise_error(NamedError, Regexp) { |error| ... }
should_not raise_error()
should_not raise_error(NamedError)
should_not raise_error(NamedError, String)
should_not raise_error(NamedError, Regexp)

With no args, matches if any error is raised. With a named error, matches only if that specific error is raised. With a named error and messsage specified as a String, matches only if both match. With a named error and messsage specified as a Regexp, matches only if both match. Pass an optional block to perform extra verifications on the exception matched

Examples

lambda { do_something_risky }.should raise_error
lambda { do_something_risky }.should raise_error(PoorRiskDecisionError)
lambda { do_something_risky }.should raise_error(PoorRiskDecisionError) { |error| error.data.should == 42 }
lambda { do_something_risky }.should raise_error(PoorRiskDecisionError, "that was too risky")
lambda { do_something_risky }.should raise_error(PoorRiskDecisionError, /oo ri/)

lambda { do_something_risky }.should_not raise_error
lambda { do_something_risky }.should_not raise_error(PoorRiskDecisionError)
lambda { do_something_risky }.should_not raise_error(PoorRiskDecisionError, "that was too risky")
lambda { do_something_risky }.should_not raise_error(PoorRiskDecisionError, /oo ri/)



125
126
127
 
# File 'lib/rspec/matchers/raise_error.rb', line 125

def raise_error(error=Exception, message=nil, &block)
  Matchers::RaiseError.new(error, message, &block)
end