Error.prototype.stack

値

文字列です。

stack プロパティは標準外であるため、実装によってその実装先が異なります。

• Firefox では、Error.prototype のアクセサープロパティです。
• Chrome および Safari では、それぞれの Error インスタンスのデータプロパティであり、記述子は次のとおりです。

解説

それぞれの JavaScript エンジンは独自の形式でスタックトレースを出力しますが、高レベルな構造は概ね一貫しています。すべての実装では、スタック内の各行が個別の関数呼び出しを表します。エラーを直接引き起こした呼び出しは最上部に配置され、呼び出しチェーン全体を開始した呼び出しは最下部に配置されます。以下にスタックトレースの例を示します。

function foo() {
  bar();
}

function bar() {
  baz();
}

function baz() {
  console.log(new Error().stack);
}

foo();

#### JavaScriptCore
baz@filename.js:10:24
bar@filename.js:6:6
foo@filename.js:2:6
global code@filename.js:13:4

#### SpiderMonkey
baz@filename.js:10:15
bar@filename.js:6:3
foo@filename.js:2:3
@filename.js:13:1

#### V8
Error
    at baz (filename.js:10:15)
    at bar (filename.js:6:3)
    at foo (filename.js:2:3)
    at filename.js:13:1

V8 は、スタックトレースをカスタマイズするための標準外のスタックトレース API を提供しています。これにはError.captureStackTrace()、Error.stackTraceLimit、Error.prepareStackTrace() が含まれます。他のエンジンもこの API に様々な程度で対応していましたが、

エンジンによってこの値を設定するタイミングは異なります。ほとんどの現代のエンジンでは、Error オブジェクトが作成された時点で設定されます。つまり、関数内で以下の方法を使用して完全なコールスタック情報を取得できます。

function foo() {
  console.log(new Error().stack);
}

throw したり捕捉したりしません。

スタックフレームは明示的な関数呼び出し以外にも存在します。例えば、イベントリスナー、タイムアウトジョブ、プロミスハンドラーはそれぞれ独自の呼び出しチェーンを開始します。 eval() および Function コンストラクター呼び出し内のソースコードもスタックに現れます。

console.log(new Function("return new Error('Function failed')")().stack);
console.log("====");
console.log(eval("new Error('eval failed')").stack);

#### JavaScriptCore
anonymous@
global code@filename.js:1:65
====
eval code@
eval@[native code]
global code@filename.js:3:17

#### SpiderMonkey
anonymous@filename.js line 1 > Function:1:8
@filename.js:1:65

====
@filename.js line 3 > eval:1:1
@filename.js:3:13

#### V8
Error: Function failed
    at eval (eval at <anonymous> (filename.js:1:13), <anonymous>:1:8)
    at filename.js:1:65
====
Error: eval failed
    at eval (eval at <anonymous> (filename.js:3:13), <anonymous>:1:1)
    at filename.js:3:13

Firefox では、//# sourceURL ディレクティブを使用して eval ソースに名前を付けることができます。Firefox の eval ソースのデバッグのドキュメントを参照してください。

例

stack プロパティの使用

以下のスクリプトは、stack プロパティを使用してスタックトレースをブラウザーウィンドウに出力する方法を示しています。これにより、ブラウザーのスタック構造がどのように見えるかを確認できます。

<div id="output"></div>

#output {
  white-space: pre;
  font-family: monospace;
}

function trace() {
  throw new Error("trace() failed");
}
function b() {
  trace();
}
function a() {
  b(3, 4, "\n\n", undefined, {});
}
try {
  a("first call, first arg");
} catch (e) {
  document.getElementById("output").textContent = e.stack;
}

仕様書

仕様書に含まれていません。

ブラウザーの互換性

関連情報

• TraceKit (GitHub)
• stacktrace.js (GitHub)
• Stack trace API (V8 docs)