テスト自動化 - 覚え書き.com

1. assertThrowsとは？

JUnit5で例外をテストする際に便利なのが assertThrows です。
従来は try-catch を使って例外を検証していましたが、コードが冗長になりがちでした。JUnit5から追加された assertThrows を使うと、例外発生をシンプルにテストできます。

import static org.junit.jupiter.api.Assertions.assertThrows;

@Test
void testException() {
    assertThrows(IllegalArgumentException.class, () -> {
        throw new IllegalArgumentException("不正な引数です");
    });
}

import static org.junit.jupiter.api.Assertions.assertThrows;

@Test

void testException() {

assertThrows(IllegalArgumentException.class, () -> {

throw new IllegalArgumentException("不正な引数です");

});

}

これだけで 「この処理で IllegalArgumentException が発生すること」 を確認できます。

2. 旧来のtry-catch方式との比較

JUnit4までの書き方は以下のようになります。

@Test
void testExceptionOld() {
    try {
        someService.doSomething(null);
        fail("例外が発生するはず");
    } catch (IllegalArgumentException e) {
        assertEquals("不正な引数です", e.getMessage());
    }
}

@Test

void testExceptionOld() {

try {

someService.doSomething(null);

fail("例外が発生するはず");

} catch (IllegalArgumentException e) {

assertEquals("不正な引数です", e.getMessage());

}

fail を入れたり、catchブロック内で assertEquals を書く必要があり、テストコードが長くなっていました。
assertThrows を使えば、これを 1行でシンプルに記述可能 です。

3. 例外メッセージの検証

assertThrows は戻り値として発生した例外オブジェクトを返すため、メッセージや詳細を検証することも可能です。@Test

void testExceptionMessage() {
    IllegalArgumentException exception = assertThrows(IllegalArgumentException.class, () -> {
        someService.doSomething("invalid");
    });
    assertEquals("不正な引数です", exception.getMessage());
}

void testExceptionMessage() {

IllegalArgumentException exception = assertThrows(IllegalArgumentException.class, () -> {

someService.doSomething("invalid");

});

assertEquals("不正な引数です", exception.getMessage());

}

これにより 例外種別だけでなく、エラーメッセージの妥当性 も簡単にチェックできます。

4. 複数の例外クラスに対応

もし異なる種類の例外が発生する可能性がある場合、複数の assertThrows を組み合わせてテストできます。

@Test
void testMultipleExceptions() {
    assertThrows(NullPointerException.class, () -> {
        someService.doSomething(null);
    });

    assertThrows(IllegalArgumentException.class, () -> {
        someService.doSomething("invalid");
    });
}

@Test

void testMultipleExceptions() {

assertThrows(NullPointerException.class, () -> {

someService.doSomething(null);

});

assertThrows(IllegalArgumentException.class, () -> {

someService.doSomething("invalid");

});

}

これにより、条件ごとに発生する例外をきちんと検証できます。

5. assertThrowsを使うメリットまとめ

コードがシンプル：try-catchやfailを省略できる
例外メッセージの検証が容易
複数パターンの例外を簡潔に記述可能
可読性が向上し、保守性もアップ

まとめ

JUnit5の assertThrows を使えば、例外発生テストがとてもスッキリ書けるようになります。
「テストコードの読みやすさ・保守性を高めたい」という方には必須のテクニックです。
これを取り入れるだけで、テストがより楽しく、効率的になるので試してみましょう！

覚え書き.com

「テスト自動化」タグアーカイブ

Javaの例外テストが楽になる！JUnit5のassertThrows便利な使い方

1. assertThrowsとは？

2. 旧来のtry-catch方式との比較

3. 例外メッセージの検証

4. 複数の例外クラスに対応

5. assertThrowsを使うメリットまとめ

まとめ

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

1. assertThrowsとは？

2. 旧来のtry-catch方式との比較

3. 例外メッセージの検証

4. 複数の例外クラスに対応

5. assertThrowsを使うメリットまとめ

まとめ

関連記事

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

　関連記事