背景

何気なく使用していた「when-thenReturn」と「doReturn-when」の違いが気になり調査したが、挙動は変わらないという記事ばかりだった。しかし、仕事で実際は挙動が違うことを教えて頂いた為、備忘録として纏める。

when-thenReturn

対象のメソッドを実際に呼び出し、戻り値を差し替える。

対象のメソッドを呼び出さないで、戻り値だけ返す。

ルート確認、呼び出し回数の確認が必要な場合は、when-thenReturnを使用する。
呼び出せない、または呼び出しをスキップしたい場合は、doReturn-whenを使用する。