281

I often want to compare arrays and make sure that they contain the same elements, in any order. Is there a concise way to do this in RSpec?

Here are methods that aren't acceptable:

#to_set

For example:

expect(array.to_set).to eq another_array.to_set

or

array.to_set.should == another_array.to_set

This fails when the arrays contain duplicate items.

#sort

For example:

expect(array.sort).to eq another_array.sort

or

array.sort.should == another_array.sort

This fails when the arrays elements don't implement #<=>

2
  • 7
    Not to smartass, but comparing to_set and size actually doesn't do what you want. E.g. [a, b, b] would match [a, a, b]. Cheers!
    – Jo Liss
    Commented Jan 27, 2011 at 22:50
  • 4
    For those who stumbled here wondering the opposite: order should be the same. Use the eq matcher, e.g. expect([1, 2]).to_not eq([2, 1])
    – Dennis
    Commented Jan 21, 2016 at 23:26

6 Answers 6

275

Since RSpec 2.11 you can also use match_array.

array.should match_array(another_array)

Which could be more readable in some cases.

[1, 2, 3].should =~ [2, 3, 1]
# vs
[1, 2, 3].should match_array([2, 3, 1])
5
  • 8
    yup, just upgraded to rails 4 and =~ stopped working where match_array works fine, thanks!
    – opsb
    Commented Dec 6, 2013 at 22:59
  • 2
    I dunno if that is more readable. Now it reads like it should be an exact match, but it isn't. The previous squiggle was vague enough to mean nothing for an array, so I didn't have the preconception. Maybe it's just me.
    – Hakanai
    Commented Mar 13, 2014 at 0:34
  • 1
    For "exact", you always have eq(), so I guess match_array() is vague enough for me.
    – awendt
    Commented Apr 11, 2014 at 10:22
  • This doesn't work for me on ordered lists. It thinks lists, which have the same items in a different order, are the same. :-(
    – djangofan
    Commented Jul 18, 2016 at 23:12
  • FWIW match_array is an alias for contain_exactly (documentation)
    – Ruy Diaz
    Commented Sep 25, 2019 at 16:59
273

Try array.should =~ another_array

The best documentation on this I can find is the code itself, which is here.

7
  • This doesn't take the order in account, so this is not an acceptable answer, is it? Quote from the docs: Passes if actual contains all of the expected regardless of order.. Commented Jan 22, 2013 at 15:44
  • 23
    Title of this post: "Rspec: “array.should == another_array” but without concern for order"
    – x1a4
    Commented Jan 22, 2013 at 16:50
  • 4
    This is now officially documented under operator matchers
    – Kelvin
    Commented Aug 12, 2013 at 15:42
  • 8
    If you're using the new "expect" syntax found in rspec 3.0, see the answer from @JoshKovach.
    – clozach
    Commented Apr 12, 2014 at 22:41
  • 57
    Rspec 3.0 syntax is expect([1, 2, 3]).to match_array([2, 1, 3]) see: stackoverflow.com/a/19436763/33226 Commented Feb 27, 2015 at 18:42
147

I've found =~ to be unpredictable and it has failed for no apparent reason. Past 2.14, you should probably use

expect([1, 2, 3]).to match_array([2, 3, 1])
1
53

Use match_array, which takes another array as an argument, or contain_exactly, which takes each element as a separate argument, and is sometimes useful for readability.

Examples:

expect([1, 2, 3]).to match_array [3, 2, 1]

or

expect([1, 2, 3]).to contain_exactly 3, 2, 1
17

For RSpec 3 use contain_exactly:

The contain_exactly matcher provides a way to test arrays against each other in a way that disregards differences in the ordering between the actual and expected array.

expect([1, 2, 3]).to    contain_exactly(2, 3, 1) # pass
expect([:a, :c, :b]).to contain_exactly(:a, :c) # fail

As others have pointed out, if you want to assert the opposite, that the arrays should match both contents and order, then use eq, ie.:

expect([1, 2, 3]).to     eq([1, 2, 3])
expect([1, 2, 3]).not_to eq([2, 3, 1])
1

not documented very well but i added links anyways:

Rspec3 docs

expect(actual).to eq(expected)


Rspec2 docs

expect([1, 2, 3]).to match_array([2, 3, 1])

3
  • 16
    Both expect(actual).to eq(expected) and expect(actual).to match_array(expected) work in rspec3, but they are doing different things. #match_array ignores the ordering, while #eq does not.
    – gucki
    Commented Oct 2, 2015 at 19:56
  • 3
    This does not answer the question, since the OP specifically asked to disregard the order. Commented May 19, 2016 at 14:19
  • Yes! This worked for me. A comparison that fails if the order of elements is not the same. Thank you! I refer to the .to eq method, not the match_array .
    – djangofan
    Commented Jul 18, 2016 at 23:17

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.