できない.dev

Vitest 5「expected "vi.fn()" to be called」の原因と直し方

Vitest 5 で expected "vi.fn()" to be called が出たら、clearMocks: false に戻すか、呼び出しを beforeEach で起こせば直る。
5 で clearMocks が既定で有効になった。

公開:

症状できない · exit 1
npx vitest run
…
 ❯ cart.test.js (2 tests | 2 failed) 5ms
   × tracks cart creation 3ms
   × tracks added items 1ms
解決後できた · exit 0
npx vitest run
…
 Test Files  1 passed (1)
      Tests  2 passed (2)
   Start at  21:50:22
   Duration  95ms (transform 54%, import 27%, tests 10%, worker 9%)

2026-11-07 に node:24(Vitest 5.1.0 / Node.js 24.22.2) で実際に打って取った出力。検証環境の詳細

要約

AssertionError: expected "vi.fn()" to be called with arguments: [ 'cart:create' ] や expected "vi.fn()" to be called 2 times, but got 1 times は、Vitest 5 に上げただけで、4 で通っていたテストが落ちるときに出る。
前者には Number of calls: 0 が続く。

5 から clearMocks の既定が true になり、各テストの前に vi.clearAllMocks() が呼ばれて、モックの呼び出しの記録が消える。
消えるのは beforeAll・セットアップファイル・ファイルの最上位で起きた呼び出しで、beforeEach とテストの中で起きた呼び出しは残る。
設定で clearMocks: false に戻すと、4 と同じ挙動になる。

実行例

node:24 のコンテナで Vitest 5.1.0 を入れ、beforeAll で起きた呼び出しを確かめるテストを打つと、2 本とも落ちて終了コード 1 になった。
clearMocks: false を書いた設定と、beforeEach への書き換えのどちらでも通った。

$ cat cart.js
export function createCart({ track }) {
  const items = [];
  track("cart:create");
  return {
    add(item) {
      items.push(item);
      track("cart:add");
    },
  };
}
$ cat cart.test.js
import { beforeAll, expect, test, vi } from "vitest";
import { createCart } from "./cart.js";
 
const track = vi.fn();
let cart;
 
beforeAll(() => {
  cart = createCart({ track });
});
 
test("tracks cart creation", () => {
  expect(track).toHaveBeenCalledWith("cart:create");
});
 
test("tracks added items", () => {
  cart.add("apple");
  expect(track).toHaveBeenCalledTimes(2);
});
$ npx vitest run
 RUN  v5.1.0 /tmp/tmp.CcIFsivb8o
 
 ❯ cart.test.js (2 tests | 2 failed) 5ms
   × tracks cart creation 3ms
   × tracks added items 1ms
 
⎯⎯⎯⎯⎯⎯⎯ Failed Tests 2 ⎯⎯⎯⎯⎯⎯⎯
 
 FAIL  cart.test.js > tracks cart creation
AssertionError: expected "vi.fn()" to be called with arguments: [ 'cart:create' ]
 
Number of calls: 0
 
 ❯ cart.test.js:12:17
     10|
     11| test("tracks cart creation", () => {
     12|   expect(track).toHaveBeenCalledWith("cart:create");
       |                 ^
     13| });
     14|
 
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯[1/2]⎯
 
 FAIL  cart.test.js > tracks added items
AssertionError: expected "vi.fn()" to be called 2 times, but got 1 times
 ❯ cart.test.js:17:17
     15| test("tracks added items", () => {
     16|   cart.add("apple");
     17|   expect(track).toHaveBeenCalledTimes(2);
       |                 ^
     18| });
     19|
 
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯[2/2]⎯
 
 Test Files  1 failed (1)
      Tests  2 failed (2)
   Start at  21:50:21
   Duration  113ms (transform 53%, import 23%, tests 15%, worker 8%)
$ echo $?
1
$ cat vitest.config.js
import { defineConfig } from "vitest/config";
 
export default defineConfig({
  test: { clearMocks: false },
});
$ npx vitest run
 RUN  v5.1.0 /tmp/tmp.CcIFsivb8o
 
 ✓ cart.test.js (2 tests) 3ms
 
 Test Files  1 passed (1)
      Tests  2 passed (2)
   Start at  21:50:22
   Duration  95ms (transform 54%, import 27%, tests 10%, worker 9%)
$ echo $?
0
$ cat cart.test.js
import { beforeEach, expect, test, vi } from "vitest";
import { createCart } from "./cart.js";
 
const track = vi.fn();
let cart;
 
beforeEach(() => {
  cart = createCart({ track });
});
 
test("tracks cart creation", () => {
  expect(track).toHaveBeenCalledWith("cart:create");
});
 
test("tracks added items", () => {
  cart.add("apple");
  expect(track).toHaveBeenCalledTimes(2);
});
$ npx vitest run
 RUN  v5.1.0 /tmp/tmp.CcIFsivb8o
 
 ✓ cart.test.js (2 tests) 3ms
 
 Test Files  1 passed (1)
      Tests  2 passed (2)
   Start at  21:50:22
   Duration  99ms (transform 50%, import 32%, worker 10%, tests 8%)
$ echo $?
0

— 2026-11-07 時点の出力

検証環境Node.js 24.22.2 / npm 11.19.1 / Python 3.11.2 / 2026-11-07 検証(ほか 2 件)
検証日
実行環境
node:24 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 24.22.2
  • npm 11.19.1
  • Python 3.11.2
  • Git 2.39.5
  • Vitest 5.1.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 設定で clearMocks を false に戻す

// vitest.config.js
import { defineConfig } from "vitest/config";
 
export default defineConfig({
  test: { clearMocks: false },
});

全部のテストが 4 と同じ挙動に戻る。
先に 5 へ上げるだけを済ませ、テストはあとで直すときに使える。

2. 呼び出しを beforeEach かテストの中で起こす

beforeEach(() => {
  cart = createCart({ track });
});

clearMocks は beforeEach より前に記録を消す。
beforeAll を beforeEach にすると、各テストの前に createCart が走り、そのとき起きた track("cart:create") がテストの中から見える。
テストごとに状態を作り直すので、ほかのテストを足したり順番を変えたりしても回数は変わらない。

3. 戻り値が消えたなら clearMocks 以外を疑う

clearMocks が消すのは呼び出しの記録だけで、mockReturnValue や mockImplementation で決めた振る舞いは残る(公式の移行ガイド(新しいタブで開く))。
最上位で mockReturnValue に決めた戻り値まで undefined になったなら、設定の mockReset が true になっている。
vi.spyOn で差し替えた関数が本物に戻るのは、mockReset か restoreMocks が true のときだ。

よくある原因

  1. beforeAll の中でテスト対象を作り、そのとき起きたモックの呼び出しをテストで確かめている。
    記録はテストの前に消えるので、toHaveBeenCalledWith は Number of calls: 0 で落ちる。
  2. 複数のテストにまたがって、モックの呼び出しの回数を数えている。
    5 では各テストが自分の中で起きた呼び出しだけを数えるので、toHaveBeenCalledTimes(2) は but got 1 times で落ちる。