JUnit 5中assertThrows() 断言预期的异常

文
章
目
录

• 1.Assertions.assertThrows()API
• 1.1 语法
• 1.2.匹配异常类型
• 2.Demo – 预期抛出异常
• 3.Demo – 抛出了不同类型的异常，或者没有抛出异常

在JUnit 5中，要编写预期会抛出异常的测试代码，我们应该使用Assertions.assertThrows()。以下测试预期将抛出ApplicationException或其子类型的异常。

@Test
void testExpectedException() {
  ApplicationException thrown = Assertions.assertThrows(ApplicationException.class, () -> {
           //测试代码
  });
  Assertions.assertEquals(\"some message\", thrown.getMessage());
}

请注意，在JUnit 4中，我们需要使用@Test(expected = NullPointerException.class)语法。

1.Assertions.assertThrows()API

1.1 语法

assertThrows()方法断言提供的可执行块或lambda表达式将抛出预期类型的异常。

static <T extends Throwable>T assertThrows(Class<T> expectedType, Executable executable)
static <T extends Throwable>T assertThrows(Class<T> expectedType, Executable executable, String message)
static <T extends Throwable>T assertThrows(Class<T> expectedType, Executable executable, Supplier<String> messageSupplier)

这是一个重载方法，需要以下参数：

• expectedType：测试代码预期抛出的异常类型。
• message：如果可执行代码没有抛出任何异常，此消息将与FAIL结果一起打印。
• messageSupplier：在测试失败时从中检索消息。

1.2.匹配异常类型

assertThrows()将失败的情况如下：

• 可执行块没有抛出任何异常
• 抛出了与预期类型不同的异常

assertThrows()将通过的情况如下：

• 代码块抛出了指定类型或其子类型的异常。例如，如果我们期望IllegalArgumentException，而测试抛出了NumberFormatException，那么测试也将通过，因为NumberFormatException扩展了IllegalArgumentException类。

注意，如果我们传递Exception.class作为预期的异常类型，可执行块中抛出的任何异常都将使断言通过，因为Exception是所有异常的超类型。

2.Demo – 预期抛出异常

下面的测试是一个非常简单的测试，它期望在执行提供的代码块时抛出NumberFormatException。

// 两个测试都将通过
@Test
void testExpectedException() {
    NumberFormatException thrown = Assertions.assertThrows(NumberFormatException.class, () -> {
        Integer.parseInt(\"One\");
    }, \"NumberFormatException was expected\");
    Assertions.assertEquals(\"For input string: \\\"One\\\"\", thrown.getMessage());
}
@Test
void testExpectedExceptionWithParentType() {
    Assertions.assertThrows(IllegalArgumentException.class, () -> {
        Integer.parseInt(\"One\");
    });
}

• 在testExpectedException中，可执行代码是Integer.parseInt(\"One\")，如果方法参数不是有效的数字，则该代码会抛出NumberFormatException。assertThrows()方法期望捕获到这个异常，因此测试结果是PASS。
• 在testExpectedExceptionWithParentType中，我们执行相同的代码，但这次我们期望的是IllegalArgumentException，它是NumberFormatException的父类。这个测试也会通过。

3.Demo – 抛出了不同类型的异常，或者没有抛出异常

如果可执行代码抛出了任何其他类型的异常，那么测试将失败。即使可执行代码没有抛出任何异常，测试也会失败。
例如，在下面这个示例中，”1″是一个有效的数字，所以不会抛出任何异常。这个测试将以控制台中的消息失败。

@Test
void testExpectedExceptionFail() {
    NumberFormatException thrown = Assertions
                .assertThrows(NumberFormatException.class, () -> {
                    Integer.parseInt(\"1\");
                }, \"NumberFormatException error was expected\");
    Assertions.assertEquals(\"Some expected message\", thrown.getMessage());
}

在这篇文章中，我们学习了如何编写一个测试来期望抛出异常。这些测试有助于测试catch块中编写的代码。