How to use RSpec's should_raise with any kind of exception?

Question

I'd like to do something like this:

some_method.should_raise <any kind of exception, I don't care>

How should I do this?

some_method.should_raise exception

... doesn't work.

score 380 · Accepted Answer · edited Jan 06 '13 at 06:59

380

expect { some_method }.to raise_error

RSpec 1 Syntax:

lambda { some_method }.should raise_error

See the documentation (for RSpec 1 syntax) and RSpec 2 documentation for more.

edited Jan 06 '13 at 06:59

Community

1
1

answered Nov 12 '09 at 15:04

Avdi

18,340
6
53
62

5

ahh.. I just noticed the curly braces! – Louis Sayers Jan 02 '14 at 17:12

score 88 · Answer 2 · edited Jun 20 '20 at 09:12

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
...

Note: raise_error and raise_exception are interchangeable.

RSpec 1

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
...

Note: raise_error is an alias for raise_exception.

Documentation: https://www.relishapp.com/rspec

RSpec 2:

https://www.relishapp.com/rspec/rspec-expectations/v/2-13/docs/built-in-matchers/raise-error-matcher

RSpec 1:

raise_error(/oops/) is a great way to check substring in exception message — Sergiy Seletskyy, Oct 05 '13 at 20:23

score 86 · Answer 3 · edited Sep 21 '12 at 18:17

86

Instead of lambda, use expect to:

   expect { some_method }.to raise_error

This is applies for more recent versions of rspec, i.e. rspec 2.0 and up.

See the doco for more.

edited Sep 21 '12 at 18:17

gerry3

21,420
9
66
74

answered Aug 09 '11 at 01:43

racc

1,222
10
13

I wouldn't use this for Rspec 1 but for Rspec 2 it works just as it should. – ericraio Mar 28 '12 at 19:34
6

Actually, according with the documentation link above, this should be **expect { some_method }.to raise_error** – Guilherme Garnier Apr 18 '12 at 22:29
Neither your comment nor the page you link to explains why `expect` is better or worse than `lambda`. – Kragen Javier Sitaker Apr 21 '12 at 17:57
1

expect is for rspec 2.0 and higher. This renders moot the argument about which one is better, since the lambda syntax doesn't work any more – Rob Aug 16 '12 at 21:48
This doesn't work for me in capybara: `expect { visit welcome_path }.to raise_error` – nnyby Dec 03 '13 at 15:16

score 65 · Answer 4 · answered Apr 28 '12 at 15:29

65

The syntax changed recently and now it is:

expect { ... }.to raise_error(ErrorClass)

answered Apr 28 '12 at 15:29

ayckoster

6,707
6
32
45

score 5 · Answer 5 · answered Aug 05 '15 at 20:40

From version 3.3 on rspec-expections gem raises a warning for a blank raise_error without a parameter

expect { raise StandardError }.to raise_error # results in warning
expect { raise StandardError }.to raise_error(StandardError) # fine

This gives you a hint that your code may fail with a different error than the test intended to check.

WARNING: Using the raise_error matcher without providing a specific error or message risks false positives, since raise_error will match when Ruby raises a NoMethodError, NameError or ArgumentError, potentially allowing the expectation to pass without even executing the method you are intending to call. Instead consider providing a specific error class or message. This message can be supressed by setting: RSpec::Expectations.configuration.warn_about_potential_false_positives = false.

How to use RSpec's should_raise with any kind of exception?

5 Answers5

RSpec 2

RSpec 1

Documentation: https://www.relishapp.com/rspec

Linked