mockReturnValue
Claude Code.icon
モック関数が呼ばれたときに返す値を設定するメソッドです。
基本的な使い方
code:ts
const fn = vi.fn()
// 常にこの値を返す
fn.mockReturnValue(42)
fn() // => 42
fn() // => 42
関連メソッドとの違い
table:_
メソッド 挙動
mockReturnValue(val) 毎回 val を返す
mockReturnValueOnce(val) 1回だけ val を返す（次の呼び出しには適用されない）
mockResolvedValue(val) Promise.resolve(val) を返す（async用）
mockImplementation(fn) 関数そのものを差し替える（より柔軟）
mockReturnValueOnce との組み合わせ
code:ts
const fn = vi.fn()
.mockReturnValueOnce(1)
.mockReturnValueOnce(2)
.mockReturnValue(99) // Once が尽きた後のデフォルト
fn() // => 1
fn() // => 2
fn() // => 99
fn() // => 99
Once はキューのように先頭から消費され、なくなると mockReturnValue で設定した値にフォールバックします。