@EnabledIfEnvironmentVariable in JUnit

Introduction

This annotation helps run tests only when a specific environment variable has a certain value. It avoids running tests in the wrong setup.

You want to run a test only on a developer's machine with a special setup.

You want to skip tests on a production server where environment variables differ.

You want to test features that depend on external services enabled by environment variables.

You want to avoid running slow tests unless a flag is set in the environment.

Syntax

JUnit

@EnabledIfEnvironmentVariable(named = "ENV_VAR_NAME", matches = "expectedValue")

The named attribute is the environment variable name to check.

The matches attribute is a regular expression to match the variable's value.

Examples

This test runs only if the environment variable ENV equals dev.

JUnit

@EnabledIfEnvironmentVariable(named = "ENV", matches = "dev")
void testOnlyOnDev() {
    // test code
}

This test runs only if RUN_SLOW_TESTS is set to true.

JUnit

@EnabledIfEnvironmentVariable(named = "RUN_SLOW_TESTS", matches = "true")
void slowTest() {
    // slow test code
}

Sample Program

The first test runs only if the environment variable TEST_MODE is set to enabled. The second test runs always.

JUnit

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable;

public class EnvVarTest {

    @Test
    @EnabledIfEnvironmentVariable(named = "TEST_MODE", matches = "enabled")
    void testRunsOnlyIfEnvVarSet() {
        System.out.println("Test is running because TEST_MODE=enabled");
    }

    @Test
    void testAlwaysRuns() {
        System.out.println("This test always runs");
    }
}

Important Notes

If the environment variable is not set or does not match, the test is skipped, not failed.

Use this to control tests in different environments without changing code.

Summary

@EnabledIfEnvironmentVariable runs tests only when an environment variable matches a value.

It helps run or skip tests based on the environment setup.

Use it to avoid running tests in wrong or unsupported 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