【Ruby3.x】Fiber::backtrace()メソッドの使い方

backtraceメソッドは、RubyのFiberオブジェクトの呼び出し履歴、いわゆるスタックトレースを取得するメソッドです。このメソッドは、Fiberが実行を一時停止した時点や、何らかの問題が発生した時点において、そのFiber内部でどのようなメソッドが呼び出されてきたかの連鎖を詳細に示します。

主にプログラムのデバッグ作業において非常に有用で、特定のFiber内で発生したエラーの原因を究明する際に、エラーがどのコードパスを通じて発生したのかを追跡するために利用されます。戻り値として、Thread::Backtrace::Locationオブジェクトの配列が返され、これには各呼び出しフレームのファイル名、行番号、メソッド名などの情報が含まれています。

まだ実行されていないFiberや、すでに実行が完了しているFiber、あるいはバックトレース情報が利用できない場合には、nilを返すことがあります。Fiberを用いた非同期処理やコルーチンのような複雑な制御フローを持つアプリケーションにおいて、backtraceメソッドはプログラムの内部状態を深く理解し、効率的なトラブルシューティングを行うための重要なツールとなります。

Copy
1fiber = Fiber.new { Fiber.yield }
2fiber.resume
3fiber.backtrace

引数なし

引数はありません

[String]

Fiber の実行が中断された時点でのコールスタック（実行履歴）を文字列の配列として返します。