StackTrace Class Reference

#include <v8.h>

Public Types
enum	StackTraceOptions {   kLineNumber = 1, kColumnOffset = 1 << 1 | kLineNumber, kScriptName = 1 << 2, kFunctionName = 1 << 3,   kIsEval = 1 << 4, kIsConstructor = 1 << 5, kScriptNameOrSourceURL = 1 << 6, kScriptId = 1 << 7,   kOverview = kLineNumber | kColumnOffset | kScriptName | kFunctionName, kDetailed = kOverview | kIsEval | kIsConstructor | kScriptNameOrSourceURL }

Public Member Functions
Local< StackFrame >	GetFrame (uint32_t index) const
int	GetFrameCount () const
Local< Array >	AsArray ()

Static Public Member Functions
static Local< StackTrace >	CurrentStackTrace (Isolate *isolate, int frame_limit, StackTraceOptions options=kOverview)

Detailed Description

Representation of a JavaScript stack trace. The information collected is a snapshot of the execution stack and the information remains valid after execution continues.

Definition at line 1274 of file v8.h.

Member Enumeration Documentation

enum StackTraceOptions

Flags that determine what information is placed captured for each StackFrame when grabbing the current stack trace.

Enumerator
kLineNumber
kColumnOffset
kScriptName
kFunctionName
kIsEval
kIsConstructor
kScriptNameOrSourceURL
kScriptId
kOverview
kDetailed

Definition at line 1280 of file v8.h.

Member Function Documentation

Local< Array > AsArray

(

)

Returns StackTrace as a v8::Array that contains StackFrame objects.

Definition at line 2189 of file api.cc.

References ENTER_V8, Utils::OpenHandle(), and Utils::ToLocal().

Referenced by AnalyzeStackInNativeCode().

Local< StackTrace > CurrentStackTrace ( Isolate *  isolate, int  frame_limit, StackTraceOptions  options = kOverview  )

static

Grab a snapshot of the current JavaScript execution stack.

Parameters

frame_limit	The maximum number of stack frames we want to capture.
options	Enumerates the set of things we will capture for each StackFrame.

Definition at line 2196 of file api.cc.

References Isolate::CaptureCurrentStackTrace(), ENTER_V8, and Utils::StackTraceToLocal().

Referenced by AnalyzeScriptIdInStack(), AnalyzeStackInNativeCode(), AnalyzeStackOfDynamicScriptWithSourceURL(), AnalyzeStackOfEvalWithSourceURL(), and AnalyzeStackOfInlineScriptWithSourceURL().

Local< StackFrame > GetFrame

(

uint32_t

index

)

const

Returns a StackFrame at a particular index.

Definition at line 2170 of file api.cc.

References Handle< T >::cast(), ENTER_V8, EscapableHandleScope::Escape(), Object::GetElementNoExceptionThrown(), Utils::OpenHandle(), and Utils::StackFrameToLocal().

Referenced by AnalyzeStackInNativeCode().

int GetFrameCount

(

)

const

Returns the number of StackFrames.

Definition at line 2182 of file api.cc.

References Smi::cast(), ENTER_V8, Utils::OpenHandle(), and Smi::value().

Referenced by AnalyzeStackInNativeCode().

---

The documentation for this class was generated from the following files:

• include/v8.h
• src/api.cc