Module: RSpec::Matchers::FailMatchers

Defined in:

lib/rspec/matchers/fail_matchers.rb

Overview

require 'rspec/matchers/fail_matchers'
RSpec.configure do |config|
  config.include RSpec::Matchers::FailMatchers
end

Instance Method Summary (collapse)

• - (Object) fail(&block)

  Matches if an expectation fails.

• - (Object) fail_including(*snippets)

  Matches if an expectation fails including the provided message.

• - (Object) fail_with(message)

  Matches if an expectation fails with the provided message.

expect { some_expectation }.to fail

17
18
19

# File 'lib/rspec/matchers/fail_matchers.rb', line 17
def fail(&block)
  raise_error(RSpec::Expectations::ExpectationNotMetError, &block)
end

expect { some_expectation }.to fail_including("portion of some failure message")

34
35
36
37
38
39

# File 'lib/rspec/matchers/fail_matchers.rb', line 34
def fail_including(*snippets)
  raise_error(
    RSpec::Expectations::ExpectationNotMetError,
    a_string_including(*snippets)
  )
end

expect { some_expectation }.to fail_with("some failure message")
expect { some_expectation }.to fail_with(/some failure message/)

26
27
28

# File 'lib/rspec/matchers/fail_matchers.rb', line 26
def fail_with(message)
  raise_error(RSpec::Expectations::ExpectationNotMetError, message)
end