Class: RSpec::Matchers::BuiltIn::RaiseError Private

Inherits:
Object
  • Object
show all
Includes:
Composable
Defined in:
lib/rspec/matchers/built_in/raise_error.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Provides the implementation for raise_error. Not intended to be instantiated directly. rubocop:disable ClassLength rubocop:disable RescueException

Instance Method Summary (collapse)

Methods included from Composable

#===, #and, #description_of, #or, should_enumerate?, surface_descriptions_in, unreadable_io?, #values_match?

Constructor Details

- (RaiseError) initialize(expected_error_or_message = nil, expected_message = nil, &block)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of RaiseError

12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# File 'lib/rspec/matchers/built_in/raise_error.rb', line 12
def initialize(expected_error_or_message=nil, expected_message=nil, &block)
  @block = block
  @actual_error = nil
  @warn_about_bare_error = warn_about_potential_false_positives? && expected_error_or_message.nil?
  case expected_error_or_message
  when nil
    @expected_error = Exception
    @expected_message = expected_message
  when String
    @expected_error = Exception
    @expected_message = expected_error_or_message
  else
    @expected_error = expected_error_or_message
    @expected_message = expected_message
  end
end

Instance Method Details

- (String) description

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns:

  • (String)
97
98
99
# File 'lib/rspec/matchers/built_in/raise_error.rb', line 97
def description
  "raise #{expected_error}"
end

- (Boolean) expects_call_stack_jump?

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns:

  • (Boolean)
79
80
81
# File 'lib/rspec/matchers/built_in/raise_error.rb', line 79
def expects_call_stack_jump?
  true
end

- (String) failure_message

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns:

  • (String)
85
86
87
# File 'lib/rspec/matchers/built_in/raise_error.rb', line 85
def failure_message
  @eval_block ? @actual_error.message : "expected #{expected_error}#{given_error}"
end

- (String) failure_message_when_negated

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns:

  • (String)
91
92
93
# File 'lib/rspec/matchers/built_in/raise_error.rb', line 91
def failure_message_when_negated
  "expected no #{expected_error}#{given_error}"
end

- (Object) with_message(expected_message)

Specifies the expected error message.

32
33
34
35
36
37
# File 'lib/rspec/matchers/built_in/raise_error.rb', line 32
def with_message(expected_message)
  raise_message_already_set if @expected_message
  @warn_about_bare_error = false
  @expected_message = expected_message
  self
end