【初心者向け】TypeScriptで使える！Jestの便利なMock Functionsまとめ

悩む人

Mock Functionsって種類がたくさんあるみたいだけど、どれが便利なの？
具体的にどう使うのか教えて！

JestのMock Functionsの中でも便利な使い方を
ピックアップしてわかりやすく解説します！

きい

この記事を書いた人

• エンジニア歴４年のフリーランスデータエンジニア
• 高卒工場勤務からエンジニア転職
• ３年目でフリーランスになり年収1000万↑達成
• フルリモ歴２年、２児の育児中

Mock Functionsの便利な種類と使い方

1. jest.fn()：基本的なMock関数

最もシンプルなMock Functionです。

関数の動作を模擬し、呼び出し回数や引数を記録します。

使い方例：

2. mockReturnValue：固定の値を返す

jest.fn()に対して、特定の戻り値を設定できます。

使い方例：

3. mockImplementation：任意の実装をモックする

実際の関数のように、任意のロジックをモックできます。

使い方例：

4. mockResolvedValue：非同期関数で値を返す

非同期処理（Promise）に対応したMock関数を作成できます。

使い方例：

5. mockRejectedValue：非同期関数でエラーを返す

非同期処理でエラーを模擬する場合に使用します。

使い方例：

6. jest.spyOn：既存の関数をスパイする

オブジェクトのメソッドをモックしつつ、元の動作を保持できます。

使い方例：

7. mockClearとmockReset：履歴をリセット

テスト中にMock関数の履歴をクリアしたい場合に使います。

違い：

• mockClear: 呼び出し履歴のみをリセット。
• mockReset: 呼び出し履歴に加えて、戻り値や実装もリセット。

使い方例：

8. mockImplementationOnce：一度だけ特定の値を返す

呼び出しごとに異なる戻り値を設定したい場合に便利です。

使い方例：

Mock Functionsのメリットを最大限活用！

Mock Functionsを使うメリット

• 外部依存の排除: APIやデータベース操作を省略してテストが可能。
• 柔軟なテスト: 任意の戻り値やエラーを簡単に設定。
• 詳細な検証: 呼び出し回数や引数の追跡が可能。

まとめ

JestのMock Functionsは、テストを効率化し、バグを防ぐ強力なツールです。

特に以下の機能を覚えておくと、初心者でもすぐに実践的なテストが書けます。

• mockReturnValueとmockResolvedValueで値をモック。
• jest.spyOnで既存関数を監視。
• mockImplementationで柔軟なロジックを実装。

JestのMock Functionsを使いこなして、テストの質を上げましょう！