Kernel.#set_trace_func と同様の機能をオブジェクト指向的な API で提供するクラスです。
例:例外に関する情報を収集する
trace = TracePoint.new(:raise) do |tp| p [tp.lineno, tp.event, tp.raised_exception] end # => #<TracePoint:0x007f786a452448> trace.enable # => false 0 / 0 # => [5, :raise, #<ZeroDivisionError: divided by 0>]
TracePoint.new または、TracePoint.trace で指定したブロックは、メソッドの引数(上記の例では :raise)に対応するイベントが発生した時に呼び出されます。
発生するイベントの詳細については、TracePoint.new を参照してください。
new(*events) {|obj| ... } -> TracePoint
[permalink][rdoc]新しい TracePoint オブジェクトを作成して返します。トレースを有効にするには TracePoint#enable を実行してください。
例:irb で実行した場合
trace = TracePoint.new(:call) do |tp| p [tp.lineno, tp.defined_class, tp.method_id, tp.event] end # => #<TracePoint:0x007f17372cdb20> trace.enable # => false puts "Hello, TracePoint!" # ... # [69, IRB::Notifier::AbstractNotifier, :printf, :call] # ...
トレースを無効にするには TracePoint#disable を実行してください。
trace.disable
式の評価。
クラス定義、特異クラス定義、モジュール定義への突入。
クラス定義、特異クラス定義、モジュール定義の終了。
Ruby で記述されたメソッドの呼び出し。
Ruby で記述されたメソッド呼び出しからのリターン。
C で記述されたメソッドの呼び出し。
C で記述されたメソッド呼び出しからのリターン。
例外の発生。
ブロックの開始。
ブロックの終了。
スレッドの開始。
スレッドの終了。
ファイバーの切り替え。
指定イベントに関連しない情報を取得するメソッドを実行した場合には RuntimeError が発生します。
TracePoint.trace(:line) do |tp| p tp.raised_exception end # => RuntimeError: 'raised_exception' not supported by this event
イベントフックの外側で、発生したイベントに関連する情報を取得するメソッドを実行した場合には RuntimeError が発生します。
TracePoint.trace(:line) do |tp| $tp = tp end $tp.lineno # => access from outside (RuntimeError)
他のスレッドから参照する事も禁じられています。
stat -> object
[permalink][rdoc]TracePoint の内部情報を返します。
返り値の内容は実装依存です。将来変更される可能性があります。
このメソッドは TracePoint 自身のデバッグ用です。
trace(*events) {|obj| ... } -> TracePoint
[permalink][rdoc]新しい TracePoint オブジェクトを作成して自動的にトレースを開始します。TracePoint.new のコンビニエンスメソッドです。
trace = TracePoint.trace(:call) { |tp| [tp.lineno, tp.event] } # => #<TracePoint:0x007f786a452448> trace.enabled? # => true
binding -> Binding
[permalink][rdoc]発生したイベントによって生成された Binding オブジェクトを返します。
def foo(ret)
ret
end
trace = TracePoint.new(:call) do |tp|
p tp.binding.local_variables # => [:ret]
end
trace.enable
foo 1
callee_id -> Symbol | nil
[permalink][rdoc]イベントが発生したメソッドの呼ばれた名前を Symbol で返します。トップレベルであった場合は nil を返します。
class C
def method_name
end
alias alias_name method_name
end
trace = TracePoint.new(:call) do |tp|
p [tp.method_id, tp.callee_id] # => [:method_name, :alias_name]
end
trace.enable do
C.new.alias_name
end
[SEE_ALSO] TracePoint#method_id
defined_class -> Class | module
[permalink][rdoc]メソッドを定義したクラスかモジュールを返します。
class C; def foo; end; end trace = TracePoint.new(:call) do |tp| p tp.defined_class # => C end.enable do C.new.foo end
メソッドがモジュールで定義されていた場合も(include に関係なく)モジュールを返します。
module M; def foo; end; end class C; include M; end; trace = TracePoint.new(:call) do |tp| p tp.defined_class # => M end.enable do C.new.foo end
[注意] 特異メソッドを実行した場合は TracePoint#defined_class は特異クラスを返します。また、Kernel.#set_trace_func の 6 番目のブロックパラメータは特異クラスではなく元のクラスを返します。
class C; def self.foo; end; end trace = TracePoint.new(:call) do |tp| p tp.defined_class # => #<Class:C> end.enable do C.foo end
Kernel.#set_trace_func と TracePoint の上記の差分に注意してください。
[SEE_ALSO] [ruby-core:50864]
disable -> bool
[permalink][rdoc]disable { ... } -> object
self のトレースを無効にします。
実行前の TracePoint#enabled? を返します。(トレースが既に有効であった場合は true を返します。そうでなければ false を返します)
trace.enabled? # => true trace.disable # => false (実行前の状態) trace.enabled? # => false trace.disable # => false
ブロックが与えられた場合、ブロック内でのみトレースが無効になります。この場合はブロックの評価結果を返します。
trace.enabled? # => true trace.disable do trace.enabled? # => false end trace.enabled? # => true
[注意] イベントフックのためのメソッドに、ブロックの外側で参照した場合は RuntimeError が発生する事に注意してください。
trace.enable { p trace.lineno } # => RuntimeError: access from outside
[SEE_ALSO] TracePoint#enable, TracePoint#enabled?
enable -> bool
[permalink][rdoc]enable { ... } -> object
self のトレースを有効にします。
実行前の TracePoint#enabled? を返します。(トレースが既に有効であった場合は true を返します。そうでなければ false を返します)
trace.enabled? # => false trace.enable # => false (実行前の状態) # トレースが有効 trace.enabled? # => true trace.enable # => true (実行前の状態) # 引き続きトレースが有効
ブロックが与えられた場合、ブロック内でのみトレースが有効になります。この場合はブロックの評価結果を返します。
trace.enabled? # => false trace.enable do trace.enabled? # => true end trace.enabled? # => false
[注意] イベントフックのためのメソッドにブロックの外側で参照した場合は RuntimeError が発生する事に注意してください。
trace.enable { p trace.lineno } # => RuntimeError: access from outside
[SEE_ALSO] TracePoint#disable, TracePoint#enabled?
enabled? -> bool
[permalink][rdoc]self のトレースが有効な場合に true を、そうでない場合に false を返します。
[SEE_ALSO] TracePoint#enable, TracePoint#disable
event -> Symbol
[permalink][rdoc]発生したイベントの種類を Symbol で返します。
発生するイベントの詳細については、TracePoint.new を参照してください。
def foo(ret)
ret
end
trace = TracePoint.new(:call, :return) do |tp|
p tp.event
end
trace.enable
foo 1
# => :call
# :return
inspect -> String
[permalink][rdoc]self の状態を人間に読みやすい文字列にして返します。
def foo(ret)
ret
end
trace = TracePoint.new(:call) do |tp|
p tp.inspect # "#<TracePoint:call `foo'@/path/to/test.rb:1>"
end
trace.enable
foo 1
lineno -> Integer
[permalink][rdoc]発生したイベントの行番号を返します。
def foo(ret)
ret
end
trace = TracePoint.new(:call, :return) do |tp|
tp.lineno
end
trace.enable
foo 1
# => 1
# 3
method_id -> Symbol | nil
[permalink][rdoc]イベントが発生したメソッドの定義時の名前を Symbol で返します。トップレベルであった場合は nil を返します。
class C
def method_name
end
alias alias_name method_name
end
trace = TracePoint.new(:call) do |tp|
p [tp.method_id, tp.callee_id] # => [:method_name, :alias_name]
end
trace.enable do
C.new.alias_name
end
[SEE_ALSO] TracePoint#callee_id
path -> String
[permalink][rdoc]イベントが発生したファイルのパスを返します。
def foo(ret)
ret
end
trace = TracePoint.new(:call) do |tp|
p tp.path # => "/path/to/test.rb"
end
trace.enable
foo 1
raised_exception -> Exception
[permalink][rdoc]発生した例外を返します。
trace = TracePoint.new(:raise) do |tp|
tp.raised_exception # => #<ZeroDivisionError: divided by 0>
end
trace.enable
begin
0/0
rescue
end
return_value -> object
[permalink][rdoc]メソッドやブロックの戻り値を返します。
def foo(ret)
ret
end
trace = TracePoint.new(:return) do |tp|
p tp.return_value # => 1
end
trace.enable
foo 1
self -> object
[permalink][rdoc]イベントを発生させたオブジェクトを返します。
以下のようにする事で同じ値を取得できます。
trace.binding.eval('self')
[SEE_ALSO] TracePoint#binding