Class: RSpec::Matchers::BuiltIn::ThrowSymbol

### Home Classes Methods

### In Files

- lib/rspec/matchers/built_in/throw_symbol.rb

### Parent

Object

### Methods

- ::new
- #==
- #description
- #failure_message_for_should
- #failure_message_for_should_not
- #matches?

### Class/Module Index

Quicksearch

- RSpec
- RSpec::Expectations
- RSpec::Expectations::DeprecatedConstants
- RSpec::Expectations::Deprecation
- RSpec::Expectations::Differ
- RSpec::Expectations::ExpectationHandler
- RSpec::Expectations::ExpectationNotMetError
- RSpec::Expectations::ExpectationTarget
- RSpec::Expectations::NegativeExpectationHandler
- RSpec::Expectations::PositiveExpectationHandler
- RSpec::Expectations::Syntax
- RSpec::Expectations::Syntax::ExpectExpressionGenerator
- RSpec::Expectations::Syntax::ShouldExpressionGenerator
- RSpec::Expectations::Version
- RSpec::Matchers
- RSpec::Matchers::BuiltIn
- RSpec::Matchers::BuiltIn::BaseMatcher
- RSpec::Matchers::BuiltIn::Be
- RSpec::Matchers::BuiltIn::BeAKindOf
- RSpec::Matchers::BuiltIn::BeAnInstanceOf
- RSpec::Matchers::BuiltIn::BeComparedTo
- RSpec::Matchers::BuiltIn::BeFalse
- RSpec::Matchers::BuiltIn::BeHelpers
- RSpec::Matchers::BuiltIn::BeNil
- RSpec::Matchers::BuiltIn::BePredicate
- RSpec::Matchers::BuiltIn::BeTrue
- RSpec::Matchers::BuiltIn::BeWithin
- RSpec::Matchers::BuiltIn::Change
- RSpec::Matchers::BuiltIn::Cover
- RSpec::Matchers::BuiltIn::EndWith
- RSpec::Matchers::BuiltIn::Eq
- RSpec::Matchers::BuiltIn::Eql
- RSpec::Matchers::BuiltIn::Equal
- RSpec::Matchers::BuiltIn::Exist
- RSpec::Matchers::BuiltIn::Has
- RSpec::Matchers::BuiltIn::Have
- RSpec::Matchers::BuiltIn::Include
- RSpec::Matchers::BuiltIn::Match
- RSpec::Matchers::BuiltIn::MatchArray
- RSpec::Matchers::BuiltIn::NegativeOperatorMatcher
- RSpec::Matchers::BuiltIn::PositiveOperatorMatcher
- RSpec::Matchers::BuiltIn::RaiseError
- RSpec::Matchers::BuiltIn::RespondTo
- RSpec::Matchers::BuiltIn::Satisfy
- RSpec::Matchers::BuiltIn::StartAndEndWith
- RSpec::Matchers::BuiltIn::StartWith
- RSpec::Matchers::BuiltIn::ThrowSymbol
- RSpec::Matchers::BuiltIn::YieldControl
- RSpec::Matchers::BuiltIn::YieldProbe
- RSpec::Matchers::BuiltIn::YieldSuccessiveArgs
- RSpec::Matchers::BuiltIn::YieldWithArgs
- RSpec::Matchers::BuiltIn::YieldWithNoArgs
- RSpec::Matchers::Configuration
- RSpec::Matchers::DSL
- RSpec::Matchers::DSL::Matcher
- RSpec::Matchers::Extensions
- RSpec::Matchers::Extensions::InstanceEvalWithArgs
- RSpec::Matchers::OperatorMatcher
- RSpec::Matchers::Pretty
- Array

No matching classes.

# RSpec::Matchers::BuiltIn::ThrowSymbol

### Public Class Methods

new(expected_symbol = nil, expected_arg=nil) click to toggle source

    # File lib/rspec/matchers/built_in/throw_symbol.rb, line 5
    def initialize(expected_symbol = nil, expected_arg=nil)
      @expected_symbol = expected_symbol
      @expected_arg = expected_arg
      @caught_symbol = @caught_arg = nil
    end

### Public Instance Methods

==(given_proc) click to toggle source
Alias for: matches?
description() click to toggle source

    # File lib/rspec/matchers/built_in/throw_symbol.rb, line 64
    def description
      "throw #{expected}"
    end

failure_message_for_should() click to toggle source

    # File lib/rspec/matchers/built_in/throw_symbol.rb, line 56
    def failure_message_for_should
      "expected #{expected} to be thrown, got #{caught}"
    end

failure_message_for_should_not() click to toggle source

    # File lib/rspec/matchers/built_in/throw_symbol.rb, line 60
    def failure_message_for_should_not
      "expected #{expected('no Symbol')}#{' not' if @expected_symbol} to be thrown, got #{caught}"
    end

matches?(given_proc) click to toggle source

    # File lib/rspec/matchers/built_in/throw_symbol.rb, line 11
    def matches?(given_proc)
      begin
        if @expected_symbol.nil?
          given_proc.call
        else
          @caught_arg = catch :proc_did_not_throw_anything do
            catch @expected_symbol do
              given_proc.call
              throw :proc_did_not_throw_anything, :nothing_thrown
            end
          end

          if @caught_arg == :nothing_thrown
            @caught_arg = nil
          else
            @caught_symbol = @expected_symbol
          end
        end

        # Ruby 1.8 uses NameError with `symbol'
        # Ruby 1.9 uses ArgumentError with :symbol
      rescue NameError, ArgumentError => e
        unless e.message =~ /uncaught throw (`|\:)([a-zA-Z0-9_]*)(')?/
          other_exception = e
          raise
        end
        @caught_symbol = $2.to_sym
      rescue => other_exception
        raise
      ensure
        unless other_exception
          if @expected_symbol.nil?
            return !@caught_symbol.nil?
          else
            if @expected_arg.nil?
              return @caught_symbol == @expected_symbol
            else
              return (@caught_symbol == @expected_symbol) & (@caught_arg == @expected_arg)
            end
          end
        end
      end
    end

Also aliased as: ==

[Validate]

Generated with the Darkfish Rdoc Generator 2.