@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.

Practice

1. What is the main purpose of the @EnabledIfEnvironmentVariable annotation in JUnit?

easy

A. To set environment variables before running tests

B. To disable all tests in a test class

C. To run a test only if a specific environment variable has a certain value

D. To run tests in parallel threads

Solution

1. Step 1: Understand the annotation's role

   <code>@EnabledIfEnvironmentVariable

2. Step 2: Identify its effect on tests

   It enables tests only when the environment variable matches the given value, skipping otherwise.

3. Final Answer:

   To run a test only if a specific environment variable has a certain value -> Option C

4. Quick Check:

   Runs test if env var matches = A [OK]

Hint: Think: runs test only if env var matches value [OK]

Common Mistakes:

• Confusing it with disabling tests
• Assuming it sets environment variables
• Thinking it controls test parallelism

2. Which of the following is the correct syntax to enable a test only when the environment variable ENV equals prod using @EnabledIfEnvironmentVariable?

easy

A. @EnabledIfEnvironmentVariable(named = "ENV", matches = "prod")

B. @EnabledIfEnvironmentVariable(name = "ENV", value = "prod")

C. @EnabledIfEnvironmentVariable(variable = "ENV", equals = "prod")

D. @EnabledIfEnvironmentVariable(env = "ENV", match = "prod")

Solution

1. Step 1: Recall correct attribute names

   The annotation uses named for the environment variable name and matches for the expected value.

2. Step 2: Match syntax with options

   @EnabledIfEnvironmentVariable(named = "ENV", matches = "prod") correctly uses named = "ENV" and matches = "prod".

3. Final Answer:

   @EnabledIfEnvironmentVariable(named = "ENV", matches = "prod") -> Option A

4. Quick Check:

   Correct attribute names = A [OK]

Hint: Remember: named and matches are correct attributes [OK]

Common Mistakes:

• Using incorrect attribute names like name or value
• Mixing attribute names with variable or env
• Using equals or match instead of matches

3. Given the following test code snippet, what will happen if the environment variable MODE is set to test?

@EnabledIfEnvironmentVariable(named = "MODE", matches = "prod")
void runOnlyInProd() {
    System.out.println("Running in prod mode");
}

medium

A. The test will be skipped and not run

B. The test will run and print "Running in prod mode"

C. The test will fail with an exception

D. The test will run but print nothing

Solution

1. Step 1: Check environment variable value

   The environment variable MODE is set to test, but the annotation requires prod.

2. Step 2: Understand annotation behavior

   Since the value does not match, the test is skipped and does not run.

3. Final Answer:

   The test will be skipped and not run -> Option A

4. Quick Check:

   Env var mismatch skips test = B [OK]

Hint: If env var value differs, test is skipped [OK]

Common Mistakes:

• Assuming test runs regardless of env var
• Expecting an exception on mismatch
• Thinking test runs but prints nothing

4. Identify the error in the following JUnit test code using @EnabledIfEnvironmentVariable:

@EnabledIfEnvironmentVariable(named = "APP_ENV", match = "dev")
void testInDev() {
    // test code
}

medium

A. The annotation must be placed on the class, not the method

B. The attribute name should be 'matches' instead of 'match'

C. The method must be static

D. The environment variable name cannot be 'APP_ENV'

Solution

1. Step 1: Check attribute names in annotation

   The correct attribute for matching value is matches, not match.

2. Step 2: Verify other code aspects

   Environment variable name can be any string, method need not be static, and annotation can be on method.

3. Final Answer:

   The attribute name should be 'matches' instead of 'match' -> Option B

4. Quick Check:

   Correct attribute is matches, not match [OK]

Hint: Use 'matches' attribute, not 'match' [OK]

Common Mistakes:

• Using 'match' instead of 'matches'
• Thinking method must be static
• Believing annotation only works on class

5. You want to run a test only if the environment variable DEPLOY_ENV is set to either staging or production. How can you achieve this using @EnabledIfEnvironmentVariable in JUnit?

hard

A. Use @EnabledIfEnvironmentVariable(named = "DEPLOY_ENV", matches = "staging,production") with comma-separated values

B. Use two test methods each annotated with @EnabledIfEnvironmentVariable(named = "DEPLOY_ENV", matches = "staging") and @EnabledIfEnvironmentVariable(named = "DEPLOY_ENV", matches = "production") respectively

C. Use @EnabledIfEnvironmentVariable(named = "DEPLOY_ENV", matches = "staging") and add an OR condition inside the test method

D. Use @EnabledIfEnvironmentVariable(named = "DEPLOY_ENV", matches = "staging|production") with regex matching

Solution

1. Step 1: Understand annotation supports regex

   The matches attribute supports regular expressions to match multiple values.

2. Step 2: Use regex for multiple values

   Using staging|production matches either value in one annotation.

3. Final Answer:

   Use @EnabledIfEnvironmentVariable(named = "DEPLOY_ENV", matches = "staging|production") with regex matching -> Option D

4. Quick Check:

   Regex in matches handles multiple values = B [OK]

Hint: Use regex in matches to cover multiple values [OK]

Common Mistakes:

• Trying to list multiple values with commas
• Splitting into multiple test methods unnecessarily
• Adding logic inside test instead of annotation