【JavaScript ECMAScript】Error::Error.stackTraceLimit静的データプロパティの使い方

Error.stackTraceLimitプロパティは、JavaScriptのErrorオブジェクトが生成するスタックトレースに表示される最大フレーム数を保持するプロパティです。このプロパティはJavaScriptランタイム全体でグローバルに設定され、新しいErrorオブジェクトが作成される際に、そのスタックトレースの長さに影響を与えます。

スタックトレースとは、プログラムの実行中にエラーが発生した際、そのエラーがどのような関数の呼び出し順序を経て発生したかを示す、一連の呼び出し履歴のことです。システムエンジニアにとって、これは問題の原因を特定し、デバッグを行う上で不可欠な情報源となります。

デフォルト値は通常10に設定されており、これにより非常に長いスタックトレースが生成されるのを防ぎ、出力の可読性を保っています。開発者はこのプロパティの値を変更することで、スタックトレースに表示されるフレームの数を調整できます。例えば、より広範囲なコンテキストでエラーを追跡するために値を増やしたり、あるいは特定の目的のために簡潔な表示が必要な場合に値を減らしたりすることが可能です。

Error.stackTraceLimitには、スタックフレームの数を表す数値型の値を設定します。この値に0を設定すると、スタックトレースは全く生成されません。これは特定の環境でエラー処理のパフォーマンスをわずかに向上させるかもしれませんが、デバッグ情報を完全に失うことになります。逆に、Infinity（無限大）を設定すると、スタックトレースのフレーム数に上限がなくなり、可能な限り全ての子呼び出し履歴が表示されるようになります。これは特に深い呼び出し階層を持つアプリケーションの複雑な問題をデバッグする際に非常に役立ちますが、極端に長いスタックトレースが生成され、メモリ使用量やログのサイズに影響を与える可能性があるため、注意が必要です。このプロパティはデバッグのニーズとアプリケーションの特性に応じて、慎重に設定することが推奨されます。

Copy
1Error.stackTraceLimit = 20;

引数なし

引数はありません

number

Error.stackTraceLimitは、スタックトレースの深さの上限を示す数値を返します。この値は、エラー発生時に取得されるコールスタックの行数を制限します。