Skip to content

Doing Nothing

Sometimes you want a call to be ignored. That can be configured like so: 

A.CallTo(() => aFake.SomeVoidMethodThatShouldDoNothing())
 .DoesNothing();

This is quite close to what a default Fake's unconfigured member will do, but there a few situations where you may need to make the DoesNothing call explicitly. Here are some examples:

  • To allow a call to a member on a strict Fake, where an otherwise unconfigured call will throw an exception.
  • To change the behavior that an already-configured call is supposed to have. For example, if a call is set to throw an exception, that can be overridden. For more on this kind of thing, see how to override the behavior for a call.
  • To fulfill FakeItEasy's configuration API requirements by providing an action when applying capturing arguments to a Fake's member. Aside from capturing, you may not want to change the behavior of the member, but you have to use some action to complete the chained calls that configure the method.
Only applies to members that return nothing

Note that DoesNothing is only applicable when configuring members that have a void return (or Task, which is the async equivalent of void). To override behavior on members that return values, you must instead configure a preferred return value.