Testing Mastery: JUnit, Mockito & Integration Tests · درس

اختبار الاستثناءات والمهلات

تحقّق من الاستثناءات المتوقعة، وطبّق مهلات زمنية لمنع الحلقات اللانهائية أو حالات الاختبار طويلة التشغيل.

اختبار الاستثناءات والمهلات درس مجاني في Testing Mastery: JUnit, Mockito & Integration Tests على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Testing Mastery: JUnit, Mockito & Integration Tests، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Testing Mastery: JUnit, Mockito & Integration Tests 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

Test for Expected Errors

Sometimes, your code is designed to throw an error under specific, invalid conditions. For example, dividing by zero. Exception testing ensures that your code handles these situations correctly.

It validates both the success and failure paths.
It confirms your error messages are accurate.

Catching Exceptions with JUnit

JUnit 5 provides the assertThrows method to verify that a specific exception is thrown. This is the recommended and cleanest way to test for expected exceptions.

It takes the expected exception type (e.g., IllegalArgumentException.class).
It takes a lambda expression (a small piece of code) that should trigger the exception.

`assertThrows` in Action

Let's see assertThrows in a simple test. Our Calculator method divide should throw an IllegalArgumentException if the divisor is zero.

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class Calculator {
    public int divide(int a, int b) {
        if (b == 0) {
            throw new IllegalArgumentException("Divisor cannot be zero");
        }
        return a / b;
    }
}

public class ExceptionTest {
    @Test
    void testDivideByZeroThrowsException() {
        Calculator calc = new Calculator();
        assertThrows(IllegalArgumentException.class, () -> {
            calc.divide(10, 0);
        });
    }
}

Checking Exception Details

It's often not enough to just know *that* an exception was thrown. You might also want to verify its details, like the exception message or other properties.

The assertThrows method returns the actual exception object, allowing you to perform further assertions on it.

Asserting Exception Message

Here, we capture the exception object returned by assertThrows and then use assertEquals to verify its message. This makes your exception tests very precise.

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class Calculator {
    public int divide(int a, int b) {
        if (b == 0) {
            throw new IllegalArgumentException("Divisor cannot be zero");
        }
        return a / b;
    }
}

public class ExceptionMessageTest {
    @Test
    void testDivideByZeroMessage() {
        Calculator calc = new Calculator();
        IllegalArgumentException thrown = assertThrows(
            IllegalArgumentException.class,
            () -> calc.divide(10, 0),
            "Expected divide() to throw, but it didn't"
        );
        assertEquals("Divisor cannot be zero", thrown.getMessage());
    }
}

Preventing Endless Tests with Timeouts

Sometimes, a piece of code can get stuck in an infinite loop or take an unexpectedly long time to complete. This can cause your test suite to hang indefinitely.

Timeouts are a crucial feature that automatically fail a test if it exceeds a specified duration, ensuring your test suite runs efficiently.

Setting Timeouts with `@Timeout`

JUnit 5 uses the @Timeout annotation to set a maximum duration for test methods or entire test classes. You specify the maximum value and a unit of time.

Common units include TimeUnit.SECONDS, TimeUnit.MILLISECONDS, TimeUnit.MINUTES.
If the test runs longer than the specified time, it will fail.

Method-Level Timeout Example

Here's how to apply a timeout to a single test method. If the longRunningTask() takes more than 1 second, this test will automatically fail.

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.Timeout;
import java.util.concurrent.TimeUnit;
import static org.junit.jupiter.api.Assertions.*;

public class TimeoutMethodTest {

    // A method that might take too long
    private void longRunningTask() throws InterruptedException {
        Thread.sleep(1500); // Simulates a task taking 1.5 seconds
    }

    @Test
    @Timeout(value = 1, unit = TimeUnit.SECONDS)
    void testTaskShouldCompleteWithinOneSecond() throws InterruptedException {
        longRunningTask(); // This will cause the test to fail due to timeout
        assertTrue(true, "Task completed (but it will timeout)");
    }
}

Class-Level Timeouts

You can also apply the @Timeout annotation at the class level. When placed on a test class, all test methods within that class will inherit the specified timeout.

If a test method also has its own @Timeout annotation, the method-level timeout will override the class-level one for that specific method.

Test Your Knowledge

Which JUnit 5 feature is best suited to ensure a test method completes execution within a predefined time limit, failing if it exceeds that limit?

Recap: Exceptions & Timeouts

In this lesson, you learned to write robust tests for expected errors and to prevent runaway tests:

You used assertThrows to verify that specific exceptions are thrown by your code.
You learned how to verify specific details of an exception, such as its message.
You applied the @Timeout annotation to set time limits for your test methods and classes, ensuring efficient test execution.

الأسئلة الشائعة

هل درس «اختبار الاستثناءات والمهلات» مجاني؟

نعم — نص درس «اختبار الاستثناءات والمهلات» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Testing Mastery: JUnit, Mockito & Integration Tests، انتقل إلى CoddyKit PRO. تتضمن دورة Testing Mastery: JUnit, Mockito & Integration Tests 4 دروس في المجموع.

ماذا ستتعلم في «اختبار الاستثناءات والمهلات»؟

تحقّق من الاستثناءات المتوقعة، وطبّق مهلات زمنية لمنع الحلقات اللانهائية أو حالات الاختبار طويلة التشغيل. تتمرن على Testing Mastery: JUnit, Mockito & Integration Tests مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Testing Mastery: JUnit, Mockito & Integration Tests؟

لا تُشترط خبرة سابقة. Testing Mastery: JUnit, Mockito & Integration Tests على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «اختبار الاستثناءات والمهلات»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Testing Mastery: JUnit, Mockito & Integration Tests هذا؟

نعم. كل درس في Testing Mastery: JUnit, Mockito & Integration Tests يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Testing Mastery: JUnit, Mockito & Integration Tests