@EnabledOnOs for OS-specific tests in JUnit - Test Execution Trace

Test Overview

This test checks that a method runs only on Windows OS using the @EnabledOnOs annotation. It verifies the test is skipped on other operating systems.

Test Code - JUnit 5

JUnit

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

public class OsSpecificTest {

    @Test
    @EnabledOnOs(OS.WINDOWS)
    void testRunsOnlyOnWindows() {
        String osName = System.getProperty("os.name").toLowerCase();
        assertTrue(osName.contains("windows"), "Test should run only on Windows OS");
    }
}

Execution Trace - 5 Steps

Step	Action	System State	Assertion	Result
1	Test runner starts and detects the test method annotated with @EnabledOnOs(OS.WINDOWS)	JUnit test environment initialized	—	PASS
2	JUnit checks the current OS from System.getProperty("os.name")	System property os.name is read, e.g., "Windows 10" or "Linux"	—	PASS
3	JUnit compares current OS with the annotation condition (Windows)	OS matches Windows if running on Windows, else does not match	—	PASS
4	If OS matches Windows, test method executes and asserts os.name contains "windows"	Test method runs on Windows OS	assertTrue(osName.contains("windows"))	PASS
5	If OS does not match Windows, test is skipped by JUnit	Test method is not executed on non-Windows OS	—	PASS

Failure Scenario

Failing Condition: Test runs on a non-Windows OS because annotation is missing or misconfigured

Execution Trace Quiz - 3 Questions

What does the @EnabledOnOs(OS.WINDOWS) annotation do in this test?

A Runs the test on all operating systems

B Runs the test only on Windows OS

C Disables the test on Windows OS

D Runs the test only on Linux OS

Key Result

Use @EnabledOnOs to run tests only on specific operating systems, preventing irrelevant test failures on other platforms.

Practice

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

easy

A. To specify the Java version for a test

B. To disable a test permanently

C. To run tests in parallel

D. To run a test only on specified operating systems

Solution

1. Step 1: Understand the role of @EnabledOnOs

   This annotation controls on which operating systems a test should run.

2. Step 2: Compare with other options

   Options B, C, and D describe different functionalities unrelated to OS-specific test execution.

3. Final Answer:

   To run a test only on specified operating systems -> Option D

4. Quick Check:

   @EnabledOnOs = Run test on specific OS [OK]

Hint: Think: runs tests only on chosen OS platforms [OK]

Common Mistakes:

• Confusing @EnabledOnOs with disabling tests
• Assuming it controls Java version
• Thinking it manages test parallelism

2. Which of the following is the correct syntax to enable a test only on Windows OS using @EnabledOnOs?

easy

A. @EnabledOnOs(OS.WINDOWS)

B. @EnabledOnOs(OS.WIN)

C. @EnabledOnOs("Windows")

D. @EnabledOnOs(os = "Windows")

Solution

1. Step 1: Recall the correct enum usage

   The @EnabledOnOs annotation uses the enum OS with constants like WINDOWS.

2. Step 2: Check each option's syntax

   @EnabledOnOs(OS.WINDOWS) uses the correct enum constant OS.WINDOWS. Options A, B, and C use invalid syntax or strings instead of enum constants.

3. Final Answer:

   @EnabledOnOs(OS.WINDOWS) -> Option A

4. Quick Check:

   Use enum OS.WINDOWS for Windows [OK]

Hint: Use enum OS constants, not strings or wrong names [OK]

Common Mistakes:

• Using string literals instead of enum constants
• Using incorrect enum names like OS.WIN
• Adding parameters incorrectly

3. Given the following test code snippet, what will happen when running on Linux OS?

@Test
@EnabledOnOs(OS.WINDOWS)
void testOnlyOnWindows() {
    System.out.println("Running Windows test");
}

medium

A. The test will run and print "Running Windows test"

B. The test will be skipped and not run

C. The test will fail with an exception

D. The test will run but print nothing

Solution

1. Step 1: Understand the annotation effect on Linux

   The test is enabled only on Windows OS, so on Linux it should not run.

2. Step 2: Determine test behavior on unsupported OS

   JUnit skips tests annotated with @EnabledOnOs if the current OS does not match.

3. Final Answer:

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

4. Quick Check:

   Test runs only on Windows, skipped on Linux [OK]

Hint: If OS doesn't match, test is skipped automatically [OK]

Common Mistakes:

• Assuming test runs but prints nothing
• Expecting a failure or exception
• Thinking test runs on all OS by default

4. Identify the error in this test code snippet:

@Test
@EnabledOnOs(OS.LINUX, OS.MAC)
void testOnUnix() {
    // test code
}

medium

A. OS.LINUX and OS.MAC are invalid enum constants

B. The annotation should be @DisabledOnOs instead

C. Multiple OS values must be inside an array

D. The method must be static to use @EnabledOnOs

Solution

1. Step 1: Check annotation parameter format

   The @EnabledOnOs annotation expects an array of OS enums when specifying multiple OSes.

2. Step 2: Identify correct syntax

   Correct syntax is @EnabledOnOs({OS.LINUX, OS.MAC}). The code misses curly braces for the array. Thus, Multiple OS values must be inside an array correctly identifies that multiple OS values must be inside an array.

3. Final Answer:

   Multiple OS values must be inside an array -> Option C

4. Quick Check:

   Use curly braces for multiple OS enums [OK]

Hint: Use curly braces {} for multiple OS enums [OK]

Common Mistakes:

• Omitting curly braces for multiple OS values
• Confusing @EnabledOnOs with @DisabledOnOs
• Thinking method must be static

5. You want a test to run only on Windows and Mac OS but skip on Linux. Which is the correct way to write the @EnabledOnOs annotation for this requirement?

hard

A. @EnabledOnOs({OS.WINDOWS, OS.MAC})

B. @EnabledOnOs(OS.WINDOWS, OS.MAC, OS.LINUX)

C. @EnabledOnOs(OS.WINDOWS) @EnabledOnOs(OS.MAC)

D. @EnabledOnOs(OS.WINDOWS & OS.MAC)

Solution

1. Step 1: Understand how to specify multiple OSes

   Multiple OSes must be provided as an array inside curly braces in @EnabledOnOs.

2. Step 2: Evaluate each option

   @EnabledOnOs({OS.WINDOWS, OS.MAC}) correctly uses an array with OS.WINDOWS and OS.MAC. @EnabledOnOs(OS.WINDOWS, OS.MAC, OS.LINUX) includes Linux, which should be excluded. @EnabledOnOs(OS.WINDOWS) @EnabledOnOs(OS.MAC) uses multiple annotations, which is invalid. @EnabledOnOs(OS.WINDOWS & OS.MAC) uses an invalid bitwise operator.

3. Final Answer:

   @EnabledOnOs({OS.WINDOWS, OS.MAC}) -> Option A

4. Quick Check:

   Use array with OS enums to include multiple OSes [OK]

Hint: Use curly braces with OS enums for multiple OSes [OK]

Common Mistakes:

• Including unwanted OS like Linux
• Using multiple @EnabledOnOs annotations
• Using invalid operators like &