メインコンテンツまでスキップ

ブロック期待値をサポートするマッチャの定義

カスタムマッチャでブロック期待値(例:expect { ... }.to matcher)をサポートする場合、これを指定する必要があります。これは、supports_block_expectation? メソッドを定義するか、またはDSLの supports_block_expectations ショートカットメソッドを使用することで手動で行うことができます。

手動でブロックマッチャを定義する

次の内容で "block_matcher_spec.rb" という名前のファイルがあるとします:

RSpec::Matchers.define :support_blocks do
match do |actual|
actual.is_a? Proc
end

def supports_block_expectations?
true # or some logic
end
end

RSpec.describe "a custom block matcher" do
specify { expect { }.to support_blocks }
end

rspec ./block_matcher_spec.rb を実行すると、

例がパスするはずです。

ショートカットを使用してブロックマッチャを定義する

次の内容で "block_matcher_spec.rb" という名前のファイルがあるとします:

RSpec::Matchers.define :support_blocks do
match do |actual|
actual.is_a? Proc
end

supports_block_expectations
end

RSpec.describe "a custom block matcher" do
specify { expect { }.to support_blocks }
end

rspec ./block_matcher_spec.rb を実行すると、

例がパスするはずです。

ショートカットを使用してブロックマッチャを定義する

次の内容で "block_matcher_spec.rb" という名前のファイルがあるとします:

RSpec::Matchers.define :support_blocks_with_errors do
match(:notify_expectation_failures => true) do |actual|
actual.call
true
end

supports_block_expectations
end

RSpec.describe "a custom block matcher" do
specify do
expect {
expect(true).to eq false
}.to support_blocks_with_errors
end
end

rspec ./block_matcher_spec.rb を実行すると、

次のエラーが発生するはずです:

Failures:

1) a custom block matcher is expected to support blocks with errors
Failure/Error: expect(true).to eq false

expected: false
got: true

(compared using ==)