Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

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

traceメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

traceメソッドは、Rubyプログラムの実行中に発生する特定のイベントを詳細に追跡し、その情報を扱うTracePointオブジェクトを生成して監視を開始するメソッドです。

このメソッドは、監視したい処理をブロックとして受け取り、そのブロック内のコード実行を監視します。引数として特定のイベントタイプ(例:メソッドの呼び出し、行の実行、例外の発生、クラスの定義など)を指定することで、監視対象を絞り込むことができます。

監視対象のイベントが発生すると、その詳細情報(イベントの種類、ファイル名、行番号、メソッド名、クラス名など)を格納したTracePointオブジェクトが生成され、traceメソッドに与えられたブロックへ渡されます。開発者はブロック内で、渡されたTracePointオブジェクトを利用して、プログラムのデバッグ、パフォーマンス分析、またはコードの実行フローの理解に役立てることができます。

この機能は、通常では追跡しにくいプログラムの内部的な挙動を把握するのに非常に有用です。ただし、広範囲な監視はプログラムの実行速度に影響を与える可能性があるため、必要な範囲に限定して利用することをおすすめします。

構文(syntax)

1TracePoint.trace(:line, :call) do |trace_point|
2  # ここにイベント発生時の処理を記述します
3end

引数(parameters)

*events

  • events: Rubyの実行中に発生するイベントのシンボルを指定する配列

戻り値(return)

Object

TracePoint#trace メソッドは、トレースイベントが発生した際に実行されるブロックを返します。

関連コンテンツ