What is the difference between stub() vs when()?

Question

I'm a bit confused with stubbing syntax.

what is the difference between:

stub(mock.someMethod()).toReturn(10);

and

when(mock.someMethod()).toReturn(10);

Answer 1

According to the stub method's documentation :

Some users find stub() confusing therefore Mockito.when(Object) is recommended over stub() .

So basically they are the same . But as the stub method returns a DeprecatedOngoingStubbing (note the word deprecated ), the when method is obviously meant to be used.

Answer 2

As specified in the official Mockito's tutorial :

when() is a successor of deprecated stub(Object)