@EnabledIfSystemProperty in JUnit - Test Execution Trace

Test Overview

This test checks if a method runs only when a specific system property is set to a certain value. It verifies conditional test execution based on system properties.

Test Code - JUnit 5

JUnit

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.condition.EnabledIfSystemProperty;
import static org.junit.jupiter.api.Assertions.assertTrue;

public class SystemPropertyTest {

    @Test
    @EnabledIfSystemProperty(named = "env", matches = "dev")
    void testRunsOnlyOnDev() {
        String env = System.getProperty("env");
        assertTrue("dev".equals(env));
    }
}

Execution Trace - 4 Steps

Step	Action	System State	Assertion	Result
1	Test framework starts and reads test annotations	JUnit test runner initialized	-	PASS
2	Check system property 'env' value	System property 'env' is set to 'dev'	System.getProperty('env') == 'dev'	PASS
3	Since property matches, testRunsOnlyOnDev() is executed	Inside test method	assertTrue("dev".equals(env))	PASS
4	Test completes successfully	Test passed	-	PASS

Failure Scenario

Failing Condition: System property 'env' is not set or does not equal 'dev'

Execution Trace Quiz - 3 Questions

What causes the test method to run?

A No system property is set

B System property 'env' equals 'dev'

C System property 'env' equals 'prod'

D Test method has no annotations

Key Result

Use @EnabledIfSystemProperty to run tests only when specific system properties are set, helping to control test execution in different environments.