Whenever someone asks a particularly salient question about testdouble.js, we’ll log it here for the benefit of anyone reading up on how to make the most use of the library.
It’s a common mistake to call td.verify
for an invocation that’s already been
stubbed with td.when
. Some users might feel like this is appropriate,
motivated by a desire to be sure that the test double was invoked as expected,
but if the stubbing was necessary to exercise the desired behavior in the
subject, then adding an additional verification is redundant.
For example, given this function:
function getName(load, id) {
return load(id).name
}
And this test:
var load = td.function()
td.when(load(42)).thenReturn({name: "Jane"})
var result = getName(load, 42)
assert(result, "Jane")
td.verify(load(42))
The assertion that result
is "Jane"
is sufficient to specify the behavior
of the function. The additional td.verify
call is redundant, because if load
had not been invoked with 42
, then there’s no way that getName
could have
returned "Jane"
, since the stubbing wouldn’t have been satisfied. Worse, it
further couples the test to the subject’s implementation—if, hypothetically, the
getName
function were able to determine the correct return value without
calling load
, the test would start failing even though there would
be nothing wrong with the implementation.
As a result, testdouble.js will print a console warning when it detects that a stubbed invocation is also being verified.
Previous: Plugins Next: Configuration