Error.prototype.stack

비표준: 이 기능은 비표준이므로 실제 프로덕션에서 사용하지 마세요. 모든 사용자 환경에서 작동하지 않을 수 도 있으며, 미래에 호환성 문제가 생길 수 있습니다.

참고: stack 속성은 사실상 모든 주요 JavaScript 엔진에서 구현되어 있으며 자바스크립트 표준 위원회에서 표준화를 모색하고 있습니다. 구현상의 불일치로 인해 스택 문자열의 정확한 내용에 의존할 수는 없지만 일반적으로 존재한다고 가정하고 디버깅 목적으로 사용할 수 있습니다.

Error 인스턴스의 비표준 stack 속성은 어떤 함수가 어떤 순서로, 어떤 줄과 파일에서, 어떤 인수를 사용하여 호출되었는지 추적할 수 있습니다. 스택 문자열은 가장 최근 호출에서 이전 호출로 진행되며, 원래의 전역 범위 호출로 되돌아갑니다.

하나의 문자열.

stack 속성은 비표준이기 때문에 구현체에 따라 위치가 다릅니다.

  • Firefox에서는 Error.prototype의 접근자 속성입니다.
  • Chrome과 Safari에서는 각 Error 인스턴스의 데이터 속성이며 다음과 같은 설명자를 가지고 있습니다.
Property attributes of Error.prototype.stack
쓰기 가능가능
열거 가능불가능
설정 가능가능

설명

각 JavaScript 엔진마다 고유한 스택 추적 형식을 사용하지만, 높은 수준의 구조는 꽤 일관적입니다. 모든 구현은 스택에서 별도의 줄을 사용하여 각 함수 호출을 나타냅니다. 오류를 직접적으로 일으킨 호출은 맨 위에 배치되고 전체 호출 체인의 시작 호출은 맨 아래에 배치됩니다. 다음은 스택 추적의 몇 가지 예입니다.

js
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

엔진마다 이 값을 설정하는 시점이 다릅니다. 대부분의 최신 엔진은 Error 객체가 생성될 때 이 값을 설정합니다. 즉, 다음을 사용하여 함수 내에서 전체 호출 스택 정보를 얻을 수 있습니다:

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

오류를 발생시킨 다음 다시 처리할 필요가 없습니다.

V8에서는 비표준 Error.captureStackTrace(), Error.stackTraceLimitError.prepareStackTrace() API를 사용하여 스택 추적을 사용자 정의할 수 있습니다. 자세한 내용은 V8 문서에서 스택 추적 API를 참조하세요.

스택 프레임은 명시적 함수 호출 이외의 것일 수도 있습니다. 예를 들어 이벤트 리스너, 타임아웃 작업, 프로미스 처리기는 모두 자체 호출 체인을 시작합니다. eval()Function 생성자 호출 내의 소스 코드도 스택에 나타납니다.

js
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 지시어를 사용하여 평가 소스의 이름을 지정할 수 있습니다. 자세한 내용은 Firefox 디버그 평가 소스 문서와 //# sourceURL 지시문을 사용하여 eval 스크립트 이름 지정하기 블로그 게시물을 참조하세요.

예제

stack 속성 사용하기

다음 스크립트는 stack 속성을 사용하여 스택 추적을 브라우저 창에 출력하는 방법을 보여줍니다. 이를 사용하여 브라우저의 스택 구조가 어떻게 보이는지 확인할 수 있습니다.

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

명세서

표준의 일부가 아닙니다.

브라우저 호환성

BCD tables only load in the browser

같이 보기