RSpecの標準Matcher一覧表

追記2（2015/09/08）ありがたいことに、未だにこの記事をブックマークしてくださる方がいらっしゃいますが、2008年に書いた記事なのでご注意下さい。内容はアップデートしていません。私自身はすでにRubyを使っていません。

追記：古い情報ですので、記事の日付とお使いのRSpecのバージョンを見比べて、参考程度にご覧ください。大部分は通用するはずですが。

Matcherをいちいち調べるのが面倒になって、公式のリファレンスマニュアルは一覧性が低いから、自分で一覧表を作った。

RSpecそのものについては、スはスペックのス 【第 1 回】 RSpec の概要と、RSpec on Rails (モデル編)などをどうぞ。そのうちRSpec on Rails版も作る予定。

名前	not((should_notで使えるかどうかという意味。))	意味・機能
==	○	==演算子を利用して比較する。ex.)"foo".should == "foo"。
be_true	○	真偽値(真)
be_false	○	真偽値(偽）
be_nil	○	nil? が真
be_empty	○	Array#empty? が真
be_述語(*args)	○	be_emptyの一般形。述語メソッドの?を除いた部分を指定して、それがtrueを返す
be_an_instance_of(Class)	○	obj.instance_of?(Class)がtrue
be_a_kind_of(Class)	○	obj.kind_of?(Class)がtrue
have_key(key)	○	obj.has_key?(key)がtrue
be_close(E,D)	○	数値データが、E±Dの範囲に収まっている
change(obj,msg,&blk)	○	Procオブジェクトが、ブロックの値を変化させる
eql(expected)	○	eql?で比較して等しい
equal(expected)	○	equal?で比較して等しい
have(n).name	○	コレクションオブジェクトが、n個の要素を持っている(nameの部分は任意。itemsとかにすると、英語として自然っぽい)。
have_exactly(n).name	×	have(n)と同じ
have_at_least(n).name	×	コレクションオブジェクトが、少なくともn個の要素を持っている
have_at_most(n).name	×	コレクションオブジェクトが、多くてもn個までの要素を持っている
include(expected)	○	コレクションオブジェクトが、expectedを要素として持っている
match(regexp)	○	正規表現regexpにマッチする
raise_error()	○	Procオブジェクトが例外を発生する
raise_error(error)	○	Procオブジェクトが例外errorを発生する
raise_error(error,msg)	○	Procオブジェクトが例外errorを、文字列msgで発生する
raise_error(error,regexp)	○	Procオブジェクトが例外errorを、regexpにマッチする文字列で発生する
respond_to(*args)	○	オブジェクトが、指定されたメソッドを全て持つ
satisfy {｜e｜ ...}	○	オブジェクトが、ブロックを真にする（ブロックの引数としてオブジェクト自身が渡される）
thorw_symbol(sym=nil)	○	symがthrowされる