Error.prototype.stack

Ein String.

Da die stack-Eigenschaft nicht standardisiert ist, unterscheiden sich die Implementierungen darin, wo sie installiert ist.

• In Firefox ist es eine Accessor-Eigenschaft auf Error.prototype.
• In Chrome und Safari ist es eine Dateneigenschaft in jeder Error-Instanz, mit dem Deskriptor:

Jede JavaScript-Engine verwendet ihr eigenes Format für Stack-Traces, aber sie sind in ihrer generellen Struktur ziemlich konsistent. Jede Implementierung verwendet eine separate Zeile im Stack, um jeden Funktionsaufruf darzustellen. Der Aufruf, der direkt den Fehler verursacht hat, wird oben platziert, und der Aufruf, der die gesamte Aufrufkette gestartet hat, wird unten platziert. Nachfolgend finden Sie einige Beispiele für Stack-Traces:

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 bietet die nicht standardisierte Stack-Trace-API zur Anpassung des Stack-Traces, einschließlich Error.captureStackTrace(), Error.stackTraceLimit, und Error.prepareStackTrace(). Andere Engines unterstützen diese API in unterschiedlichem Maße.

Verschiedene Engines setzen diesen Wert zu unterschiedlichen Zeiten. Die meisten modernen Engines setzen ihn, wenn das Error-Objekt erstellt wird. Das bedeutet, dass Sie die vollständige Aufrufkette innerhalb einer Funktion wie folgt erhalten können:

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

Ohne einen Fehler werfen und dann abfangen zu müssen.

Stack-Frames können auch Elemente sein, die keine expliziten Funktionsaufrufe sind. Beispielsweise beginnen Event-Listener, Timeout-Jobs und Promise-Handler ihre eigene Aufrufkette. Quellcode innerhalb von eval()- und Function-Konstruktoraufrufen erscheint ebenfalls im Stack:

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

In Firefox können Sie die Direktive //# sourceURL verwenden, um eine eval-Quelle zu benennen. Siehe die Firefox-Dokumentation Debug eval sources und den Blogbeitrag Naming eval Scripts with the //# sourceURL Directive für weitere Details.

Das folgende Skript demonstriert, wie Sie die stack-Eigenschaft verwenden können, um einen Stack-Trace in Ihr Browserfenster auszugeben. Sie können dies verwenden, um zu überprüfen, wie die Stack-Struktur in Ihrem Browser aussieht.

<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;
}

Kein Teil eines Standards.

• TraceKit auf GitHub
• stacktrace.js auf GitHub
• Stack trace API in den V8-Dokumenten