contain_exactly マッチャー

contain_exactly マッチャーは、実際の配列と期待される配列の順序の違いを無視して、配列同士をテストする方法を提供します。 例えば:

expect([1, 2, 3]).to    contain_exactly(2, 3, 1) # パスする
expect([:a, :c, :b]).to contain_exactly(:a, :c ) # 失敗する

このマッチャーは match_array としても利用できます。match_array は、期待される配列を個々の要素ではなく、単一の配列引数として指定するものです。上記の例は以下のように書くこともできます:

expect([1, 2, 3]).to    match_array [2, 3, 1] # パスする
expect([:a, :c, :b]).to match_array [:a, :c]  # 失敗する

配列にはすべての値が含まれることが期待されます

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

RSpec.describe [1, 2, 3] do
  it { is_expected.to contain_exactly(1, 2, 3) }
  it { is_expected.to contain_exactly(1, 3, 2) }
  it { is_expected.to contain_exactly(2, 1, 3) }
  it { is_expected.to contain_exactly(2, 3, 1) }
  it { is_expected.to contain_exactly(3, 1, 2) }
  it { is_expected.to contain_exactly(3, 2, 1) }

  # deliberate failures
  it { is_expected.to contain_exactly(1, 2, 1) }
end

rspec contain_exactly_matcher_spec.rb を実行すると

出力に "7 examples, 1 failure" が含まれること

かつ、出力に以下が含まれること:

     Failure/Error: it { is_expected.to contain_exactly(1, 2, 1) }

       expected collection contained:  [1, 1, 2]
       actual collection contained:    [1, 2, 3]
       the missing elements were:      [1]
       the extra elements were:        [3]

配列にはすべての値が含まれないことが期待されます

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

RSpec.describe [1, 2, 3] do
  it { is_expected.to_not contain_exactly(1, 2, 3, 4) }
  it { is_expected.to_not contain_exactly(1, 2) }

  # deliberate failures
  it { is_expected.to_not contain_exactly(1, 3, 2) }
end

rspec contain_exactly_matcher_spec.rb を実行すると

出力に "3 examples, 1 failure" が含まれること

かつ、出力に以下が含まれること:

     Failure/Error: it { is_expected.to_not contain_exactly(1, 3, 2) }
       expected [1, 2, 3] not to contain exactly 1, 3, and 2