Argument captors in JUnit - Test Execution Trace

Test Overview

This test verifies that a method correctly calls a dependency with the expected argument by capturing the argument passed to a mocked method using an argument captor.

Test Code - JUnit + Mockito

JUnit

import static org.mockito.Mockito.*;
import static org.junit.jupiter.api.Assertions.*;
import org.junit.jupiter.api.Test;
import org.mockito.ArgumentCaptor;

class UserServiceTest {

    interface UserRepository {
        void saveUser(String username);
    }

    static class UserService {
        private final UserRepository repo;

        UserService(UserRepository repo) {
            this.repo = repo;
        }

        void registerUser(String username) {
            // Some logic before saving
            repo.saveUser(username);
        }
    }

    @Test
    void testRegisterUserCapturesArgument() {
        UserRepository mockRepo = mock(UserRepository.class);
        UserService service = new UserService(mockRepo);

        service.registerUser("alice");

        ArgumentCaptor<String> captor = ArgumentCaptor.forClass(String.class);
        verify(mockRepo).saveUser(captor.capture());

        String capturedArg = captor.getValue();
        assertEquals("alice", capturedArg);
    }
}

Execution Trace - 8 Steps

Step	Action	System State	Assertion	Result
1	Test starts	JUnit test runner initializes the test class UserServiceTest	-	PASS
2	Creates a mock UserRepository using Mockito	mockRepo is a mock object that records interactions	-	PASS
3	Creates UserService instance with mockRepo injected	UserService instance ready to use mockRepo	-	PASS
4	Calls registerUser("alice") on UserService	Inside registerUser, calls mockRepo.saveUser("alice")	-	PASS
5	Creates ArgumentCaptor for String class	ArgumentCaptor ready to capture String arguments	-	PASS
6	Verifies mockRepo.saveUser was called and captures the argument	Captured argument is stored inside captor	Verify that saveUser was called once with any String argument	PASS
7	Retrieves captured argument and asserts it equals "alice"	Captured argument is "alice"	assertEquals("alice", capturedArg)	PASS
8	Test ends successfully	Test passed with all assertions met	-	PASS

Failure Scenario

Failing Condition: The method saveUser was not called or called with a different argument than expected

Execution Trace Quiz - 3 Questions

What does the ArgumentCaptor capture in this test?

A The number of times saveUser was called

B The return value of saveUser method

C The argument passed to the mockRepo.saveUser method

D The exception thrown by saveUser

Key Result

Using argument captors helps verify that methods are called with the correct data, improving test accuracy beyond just checking if a method was called.