Ruby TracePoint類用法及代碼示例

Document-class： TracePoint

在麵向對象的 API 中提供 Kernel#set_trace_func 函數的類。

示例

我們可以使用 TracePoint 專門針對異常收集信息：

trace = TracePoint.new(:raise) do |tp|
    p [tp.lineno, tp.event, tp.raised_exception]
end
#=> #<TracePoint:disabled>

trace.enable
#=> false

0 / 0
#=> [5, :raise, #<ZeroDivisionError: divided by 0>]

事件

如果您未指定要偵聽的事件類型， TracePoint 將包括所有可用事件。

注意不要依賴於當前的事件集，因為此列表可能會發生變化。相反，建議您指定要使用的事件類型。

要過濾跟蹤的內容，您可以將以下任何內容作為 events 傳遞：

:line

在新行上執行表達式或語句

:class

開始一個類或模塊定義

:end

完成一個類或模塊定義

:call

調用 Ruby 方法

:return

從 Ruby 方法返回

:c_call

調用 C-language 例程

:c_return

從 C-language 例程返回

:raise

引發異常

:b_call

塊入口處的事件鉤子

:b_return

塊結束時的事件鉤子

:a_call

所有調用的事件鉤子( call ， b_call 和 c_call )

:a_return

所有返回的事件鉤子( return 、 b_return 和 c_return )

:thread_begin

線程開始處的事件鉤子

:thread_end

線程結束時的事件鉤子

:fiber_switch

光纖交換機上的事件鉤子

:script_compiled

編譯新的 Ruby 代碼(使用 eval 、 load 或 require )