Error.prototype.stack

Giá trị

Một chuỗi.

Vì thuộc tính stack không chuẩn, các triển khai khác nhau về nơi nó được cài đặt.

• Trong Firefox, đây là thuộc tính accessor trên Error.prototype.
• Trong Chrome và Safari, đây là thuộc tính dữ liệu trên mỗi instance Error, với bộ mô tả:

Mô tả

Mỗi JavaScript engine sử dụng định dạng riêng cho stack trace, nhưng chúng khá nhất quán ở cấu trúc cấp cao. Mọi triển khai đều dùng một dòng riêng trong stack để biểu diễn mỗi lời gọi hàm. Lời gọi trực tiếp gây ra lỗi được đặt ở đầu, và lời gọi bắt đầu toàn bộ chuỗi gọi được đặt ở cuối. Dưới đây là một số ví dụ về stack trace:

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 cung cấp stack trace API không chuẩn để tùy chỉnh stack trace, bao gồm Error.captureStackTrace(), Error.stackTraceLimit, và Error.prepareStackTrace(). Các engine khác hỗ trợ API này ở các mức độ khác nhau.

Các engine khác nhau thiết lập giá trị này vào các thời điểm khác nhau. Hầu hết các engine hiện đại thiết lập nó khi đối tượng Error được tạo. Điều này có nghĩa là bạn có thể lấy toàn bộ thông tin call stack trong một hàm bằng cách sau:

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

Mà không cần ném lỗi rồi bắt lại.

Stack frame cũng có thể là những thứ khác ngoài lời gọi hàm tường minh. Ví dụ, event listener, timeout job, và promise handler đều bắt đầu chuỗi gọi riêng của chúng. Code nguồn bên trong eval() và lời gọi constructor Function cũng xuất hiện trong 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

Trong Firefox, bạn có thể dùng chỉ thị //# sourceURL để đặt tên cho nguồn eval. Xem tài liệu Firefox Debug eval sources.

Ví dụ

Sử dụng thuộc tính stack

Script sau minh họa cách sử dụng thuộc tính stack để xuất một stack trace vào cửa sổ trình duyệt. Bạn có thể dùng điều này để kiểm tra cấu trúc stack của trình duyệt của bạn trông như thế nào.

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

Đặc tả kỹ thuật

Không thuộc bất kỳ tiêu chuẩn nào.

Tương thích trình duyệt

Xem thêm

• TraceKit trên GitHub
• stacktrace.js trên GitHub
• Stack trace API trong tài liệu V8