More than 5 years have passed since last update.

RSpec - expectの中を汚さずに複雑な検証ができるsatisfyマッチャがすごい

Last updated at 2015-02-13Posted at 2015-02-13

やりたいこと

配列の中に数値が格納されていて、数値の桁数が全て8桁であることを検証したい。というケースがありました。

allというマッチャで、配列の要素全てに対してマッチャを適用できるのですが、「数値の桁数が◯桁であること」を検証してくれるマッチャはないので、自分でなんとかしないといけませんでした。

mapメソッドを使って、数値の配列を桁数の配列に変換し、allマッチャに渡す方法。

xxx_spec.rb

it { expect(nums.map{|num|num.abs.to_s.size}).to all(eq 8) }

うーん…
なんだか気持ち悪い

xxx_spec.rb

it '全ての数が8桁であること' do
  nums.each do |num|
    expect(num.abs.to_s.size).to eq 8
  end
end

うーん…
大して変わらない

どちらもexpectに渡すのが、検証したい対象を変換したもの になっているのが気持ち悪さの原因のような気がします。

expectには数値を渡して、マッチャが「マイナスを取って文字列にしたら長さが8であること」を検証してくれたらいいのになあ。と思っていました。

satisfyというマッチャを見つけました。これはブロックを受け取って、そのブロックがtrueを返すことを検証してくれます。
辞書を引いてみると、(人を)満足させるとか**(要件を)満たす**という意味らしいです。
これを使えば気持ち悪くない書き方ができそうです。

xxx_spec.rb

it { expect(nums).to all(satisfy {|num| num.abs.to_s.size == 8 } ) }

ちょっと自然な感じになりました。
ただ、カッコが多くて見づらいのでブロックを分けます。

xxx_spec.rb

be_8_digits = -> num { num.abs.to_s.size == 8 }
it { expect(nums).to all(satisfy &be_8_digits) }

スッキリしました。

expectの中が、検証すべき対象になったので、subjectでまとめてis_expected.toすることもできます。