How to mock/test method that returns void, possibly in Mockito

I came across a problem and I can't find an elegant solution.

So the problem is with a mock of Selenium web driver, and I dont know how should I test/mock void methods.

public void clickAndWait(String locator) {
    if(isElementPresent(locator) == false) throw some exception;
    selenium.clickAndWait(); //a problematic delegating call to selenium
}

So what I am asking is, how to properly test such a method, one test would be for exception being thrown, but how properly make test of that void method I delegate to?

The following code sample from this Mockito documentation illustrates how to mock a void method:

doThrow(new RuntimeException()).when(mockedList).clear();

// following throws RuntimeException:
mockedList.clear();

doAnswer(new Answer<Void>() {
        @Override
        public Void answer(InvocationOnMock invocation) throws Throwable {

            return null;
        }
    }).when(mock).method((SomeClass) anyObject());

The previous answers have been stressing on doing something (throwing an exception possibly) at every call. This way when you do something like :

doThrow(new RuntimeException()).when(mockedList).clear();

and then call the stubbed service (or logic) like :

mockedList.clear();

it will generate an exception. What if you want to test for a proper functioning of method maybe writing positive test case. Mocking a void returning method for such case could be done by :

doNothing().when(mockedList).clear();

which means that since you stubbed the clear() method for mockedList mock, you can be sure that this method is not going to effect the logic of the unit and still you can check the rest of the flow without generating an exception.

You can also use:

• The method Mockito.verify(mock/spy) to check how many times the method has been called.
• Or use the argument captor to see/check some parameters passed to the void method.

You can trow an exception on your method call, here is a small example how to do it:

doThrow(new RuntimeException()).when(mockedList).clear();

then you call mockedList.clear(); mocked method will throw an exception.

Or you can count how many times your method was called, here is a small example how to do it:

verify(mockedList, times(1)).clear(); 

In Java 8 this can be made a little cleaner

doAnswer((i) -> {
  // Do stuff with i.getArguments() here
  return null;
}).when(*mock*).*method*(*methodArguments*);

The return null; is important and without it the compile will fail with some fairly obscure errors as it won't be able to find a suitable override for doAnswer.