【Rails】minitest内で例外を発生させる

Posted at 2025-08-30

はじめに

minitest内で例外を任意で発生させる方法について整理してまとめます。

方法	コード例	副作用の有無	特徴
① stub	`obj.stub(:fail, -> {raise "RuntimeError"}) {...}`	なし（ブロック内のみ有効）	一時的にメソッドを差し替えられる。元のオブジェクトを汚さない
② 特異メソッド	`def obj.fail; raise "RuntimeError"; end`	あり（同じインスタンスを再利用すると残る）	直感的に書ける
③ define_method	`klass = Class.new {define_method(:fail) {raise "RuntimeError"}}`	あり（クラスを共有すると残る）	複数メソッドをまとめて定義できる
④ Minitest::Mock	`mock = Minitest::Mock.new; def mock.fail; raise "RuntimeError"; end; mock.expect(:fail, nil); ...`	なし（テストごとに新規作成）	`expect`メソッドと組み合わせる。呼び出し回数や引数の検証も可能
⑤ Proc / lambda	`assert_raises(RuntimeError, &-> {raise "RuntimeError"})`	なし	最小限のコードで例外テスト可能

obj = Object.new
def obj.fail; end

obj.stub(:fail, -> {raise "RuntimeError"}) do
  assert_raises(RuntimeError){obj.fail}
end

stubで一時的に例外を仕込む
- ObjectクラスはRubyの全てのクラスの祖先（BasicObjectを除く）。何の振る舞いも持たない、テスト用のダミーオブジェクトを作成する際に重宝される
ブロックの中だけで差し替わるので副作用が残らない

obj = Object.new
def obj.fail
  raise "RuntimeError"
end

assert_raises(RuntimeError){obj.fail}

klass = Class.new do
  define_method(:fail) do
    raise "RuntimeError"
  end
end

obj = klass.new
assert_raises(RuntimeError) {obj.fail}

mock = Minitest::Mock.new

def mock.fail
  raise "RuntimeError"
end

mock.expect(:fail, nil)

assert_raises(RuntimeError) {mock.fail}
mock.verify

raise_proc = -> {raise "RuntimeError"}
assert_raises(RuntimeError, &raise_proc)