to equal
Asserts deep equality.
expect({ a: 'b' }, 'to equal', { a: 'b' });
var now = new Date();
expect(now, 'to equal', now);
expect(now, 'to equal', new Date(now.getTime()));
expect({ now: now }, 'to equal', { now: now });
For a lot of types a failing equality test results in a nice diff. Below you can see some examples of the diffs.
An object diff containing a string diff:
expect({ text: 'foo!' }, 'to equal', { text: 'f00!' });
expected { text: 'foo!' } to equal { text: 'f00!' }
{
text:
'foo!'
//
//
//
should equal
'f00!'
-
foo!
+
f00!
}
A diff between objects with different keys.
expect({ one: 1, two: 2, four: 4, five: 5 }, 'to equal', { one: 1, two: 2, three: 3, four: 4 });
expected { one: 1, two: 2, four: 4, five: 5 } to equal { one: 1, two: 2, three: 3, four: 4 }
{
one: 1,
two: 2,
four: 4,
five: 5,
//
should be removed
three:
undefined
//
should equal
3
}
A diff between two arrays.
expect([ 0, 1, 2, 4, 5], 'to equal', [ 1, 2, 3, 4]);
expected [ 0, 1, 2, 4, 5 ] to equal [ 1, 2, 3, 4 ]
[
0, // should be removed
1,
2,
//
missing
3
4,
5 // should be removed
]
A diff between two buffers.
expect(
new Buffer('\x00\x01\x02Here is the thing I was talking about', 'utf-8'),
'to equal',
new Buffer('\x00\x01\x02Here is the thing I was quuxing about', 'utf-8')
);
expected Buffer([0x00, 0x01, 0x02, 0x48, 0x65, 0x72, 0x65, 0x20, 0x69, 0x73, 0x20, 0x74, 0x68, 0x65, 0x20, 0x74 /* 24 more */ ])
to equal Buffer([0x00, 0x01, 0x02, 0x48, 0x65, 0x72, 0x65, 0x20, 0x69, 0x73, 0x20, 0x74, 0x68, 0x65, 0x20, 0x74 /* 24 more */ ])
00 01 02 48 65 72 65 20 69 73 20 74 68 65 20 74 │...Here is the t│
-
68 69 6E 67 20 49 20 77 61 73 20 74 61 6C 6B 69 │hing I was talki│
+
68 69 6E 67 20 49 20 77 61 73 20 71 75 75 78 69 │hing I was quuxi│
6E 67 20 61 62 6F 75 74 │ng about│
This assertion can be negated using the not
flag:
expect(1, 'not to equal', '1');
expect({ one: 1 }, 'not to equal', { one: '1' });
expect(null, 'not to equal', '1');
var now = new Date();
var later = new Date(now.getTime() + 42);
expect(now, 'not to equal', later);
expect({ time: now }, 'not to equal', { time: later });
In case of a failing expectation you get the following output:
expect({ a: { b: 'd'} }, 'not to equal', { a: { b: 'd'} });
expected { a: { b: 'd' } } not to equal { a: { b: 'd' } }