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

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

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

作成日: 更新日:

基本的な使い方

backtraceメソッドは、RubyのExceptionクラスに属し、プログラム実行中に発生した例外のスタックトレース情報を取得するメソッドです。スタックトレースとは、例外が発生した時点までのメソッド呼び出し履歴や、コードの実行経路を記録した一連の情報のことを指します。

このメソッドを呼び出すと、例外が発生したファイル名、行番号、そしてその行が属するメソッド名やブロック情報といった詳細な文字列の配列が返されます。配列の各要素は、最新の呼び出し(つまり例外発生箇所に最も近い実行ステップ)から順に、過去の呼び出しへと並んでいます。

システムエンジニアを目指す初心者の方にとって、プログラムのデバッグは非常に重要なスキルですが、このbacktraceメソッドはデバッグ作業の強力な助けとなります。例えば、プログラムが予期せぬエラーで停止した際に、発生した例外オブジェクトに対してbacktraceメソッドを使用することで、エラーがどのファイルの何行目で、どのようなメソッド呼び出しの連鎖を経て発生したのかを正確に把握することができます。これにより、問題の原因を迅速に特定し、修正する手掛かりを得られます。

プログラムのエラーログにスタックトレースを含めることで、本番環境での問題発生時にも詳細な情報を残し、効率的な障害対応に繋げることが可能です。エラー発生時の状況を深く理解するために不可欠なメソッドと言えます。

構文(syntax)

1begin
2  raise "エラーが発生しました"
3rescue => e
4  e.backtrace
5end

引数(parameters)

引数なし

引数はありません

戻り値(return)

Array<String> | nil

例外発生時のコールスタック(呼び出し履歴)を文字列の配列として返します。例外が発生していない場合は nil を返します。

関連コンテンツ