モジュールモックのバイパス

非公式ベータ版翻訳

このページは PageTurner AI で翻訳されました（ベータ版）。プロジェクト公式の承認はありません。 エラーを見つけましたか？ 問題を報告 →

Jestではテストでモジュール全体をモック化できます。これはコードがモジュールの関数を正しく呼び出しているか検証するのに便利です。しかし、_テストファイル_内でモック化されたモジュールの一部を元の実装として使用したい場合があります。そのようなケースではモック版ではなくオリジナルの実装にアクセスする必要があります。

このcreateUser関数のテストケースを考えてみましょう：

createUser.js

import fetch from 'node-fetch';

export const createUser = async () => {
  const response = await fetch('https://website.com/users', {method: 'POST'});
  const userId = await response.text();
  return userId;
};

テストではfetch関数をモック化して、実際のネットワークリクエストを行わずに呼び出されることを確認したいでしょう。しかし同時に、fetchの戻り値をPromiseでラップされたResponseオブジェクトでモックする必要もあります。なぜならこの関数は作成されたユーザーのIDを取得するためにそれを使用するからです。最初は次のようなテストを書くかもしれません：

jest.mock('node-fetch');

import fetch, {Response} from 'node-fetch';
import {createUser} from './createUser';

test('createUser calls fetch with the right args and returns the user id', async () => {
  fetch.mockReturnValue(Promise.resolve(new Response('4')));

  const userId = await createUser();

  expect(fetch).toHaveBeenCalledTimes(1);
  expect(fetch).toHaveBeenCalledWith('https://website.com/users', {
    method: 'POST',
  });
  expect(userId).toBe('4');
});

しかしこのテストを実行すると、createUser関数が失敗しTypeError: response.text is not a functionエラーが発生します。これはテストファイルの先頭にあるjest.mock呼び出しによって、node-fetchからインポートしたResponseクラスがモック化され、本来の動作をしなくなっているためです。

このような問題を回避するために、Jestはjest.requireActualヘルパーを提供しています。上記のテストを動作させるには、テストファイルのインポートを次のように変更します：

// BEFORE
jest.mock('node-fetch');
import fetch, {Response} from 'node-fetch';

// AFTER
jest.mock('node-fetch');
import fetch from 'node-fetch';
const {Response} = jest.requireActual('node-fetch');

これによりテストファイルはモック版ではなく、node-fetchから実際のResponseオブジェクトをインポートできるようになります。これでテストは正しくパスするようになります。