@EnabledIfEnvironmentVariable in JUnit - Test Execution Trace

Test Overview

This test checks if a feature runs only when a specific environment variable is set to a certain value. It verifies conditional test execution based on environment settings.

Test Code - JUnit 5

JUnit

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

public class EnvVariableTest {

    @Test
    @EnabledIfEnvironmentVariable(named = "RUN_FEATURE", matches = "true")
    void testFeatureRunsOnlyIfEnvVarIsTrue() {
        // Simulate feature logic
        boolean featureActive = true;
        assertTrue(featureActive, "Feature should be active when RUN_FEATURE=true");
    }
}

Execution Trace - 4 Steps

Step	Action	System State	Assertion	Result
1	Test runner starts and checks environment variable RUN_FEATURE	Environment variable RUN_FEATURE is set to 'true'	-	PASS
2	JUnit detects @EnabledIfEnvironmentVariable condition is met and runs testFeatureRunsOnlyIfEnvVarIsTrue()	Test method is executing	-	PASS
3	Inside test, assertTrue(featureActive) is called	featureActive is true	assertTrue(featureActive) verifies featureActive is true	PASS
4	Test completes successfully	Test passed	-	PASS

Failure Scenario

Failing Condition: Environment variable RUN_FEATURE is not set to 'true' or is missing

Execution Trace Quiz - 3 Questions

What causes the test to run in this example?

A No environment variable is needed

B RUN_FEATURE environment variable is set to 'false'

C RUN_FEATURE environment variable is set to 'true'

D Test always runs regardless of environment

Key Result

Use @EnabledIfEnvironmentVariable to run tests only when specific environment variables are set, helping control test execution in different environments.