v8::StackTrace Class Reference

Representation of a JavaScript stack trace. More...

#include <v8.h>

Collaboration diagram for v8::StackTrace:

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 ,   kExposeFramesAcrossSecurityOrigins = 1 << 8 , kOverview = kLineNumber | kColumnOffset | kScriptName | kFunctionName , kDetailed = kOverview | kIsEval | kIsConstructor | kScriptNameOrSourceURL }
	Flags that determine what information is placed captured for each StackFrame when grabbing the current stack trace. More...

Public Member Functions
Local< StackFrame >	GetFrame (uint32_t index) const
	Returns a StackFrame at a particular index. More...
int	GetFrameCount () const
	Returns the number of StackFrames. More...
Local< Array >	AsArray ()
	Returns StackTrace as a v8::Array that contains StackFrame objects. More...

Static Public Member Functions
static Local< StackTrace >	CurrentStackTrace (Isolate *isolate, int frame_limit, StackTraceOptions options=kOverview)
	Grab a snapshot of the current JavaScript execution stack. More...

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 1306 of file v8.h.

Member Enumeration Documentation

StackTraceOptions

enum v8::StackTrace::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
kExposeFramesAcrossSecurityOrigins
kOverview
kDetailed

Definition at line 1312 of file v8.h.

                         {
    kLineNumber = 1,
    kColumnOffset = 1 << 1 | kLineNumber,
    kScriptName = 1 << 2,
    kFunctionName = 1 << 3,
    kIsEval = 1 << 4,
    kIsConstructor = 1 << 5,
    kScriptNameOrSourceURL = 1 << 6,
    kScriptId = 1 << 7,
    kExposeFramesAcrossSecurityOrigins = 1 << 8,
    kOverview = kLineNumber | kColumnOffset | kScriptName | kFunctionName,
    kDetailed = kOverview | kIsEval | kIsConstructor | kScriptNameOrSourceURL
  };

Member Function Documentation

AsArray()

Local< Array > v8::StackTrace::AsArray

(

)

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

Definition at line 2265 of file api.cc.

                                 {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ENTER_V8(isolate);
  return Utils::ToLocal(Utils::OpenHandle(this));
}

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

Here is the call graph for this function:

CurrentStackTrace()

Local< StackTrace > v8::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 2272 of file api.cc.

                               {
  i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate);
  ENTER_V8(i_isolate);
  // TODO(dcarney): remove when ScriptDebugServer is fixed.
  options = static_cast<StackTraceOptions>(
      static_cast<int>(options) | kExposeFramesAcrossSecurityOrigins);
  i::Handle<i::JSArray> stackTrace =
      i_isolate->CaptureCurrentStackTrace(frame_limit, options);
  return Utils::StackTraceToLocal(stackTrace);
}

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

Here is the call graph for this function:

GetFrame()

Local< StackFrame > v8::StackTrace::GetFrame

(

uint32_t

index

)

const

Returns a StackFrame at a particular index.

Definition at line 2246 of file api.cc.

                                                           {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ENTER_V8(isolate);
  EscapableHandleScope scope(reinterpret_cast<Isolate*>(isolate));
  i::Handle<i::JSArray> self = Utils::OpenHandle(this);
  i::Handle<i::Object> obj =
      i::Object::GetElement(isolate, self, index).ToHandleChecked();
  i::Handle<i::JSObject> jsobj = i::Handle<i::JSObject>::cast(obj);
  return scope.Escape(Utils::StackFrameToLocal(jsobj));
}

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

Here is the call graph for this function:

GetFrameCount()

int v8::StackTrace::GetFrameCount

(

)

const

Returns the number of StackFrames.

Definition at line 2258 of file api.cc.

                                    {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ENTER_V8(isolate);
  return i::Smi::cast(Utils::OpenHandle(this)->length())->value();
}

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

Here is the call graph for this function:

---

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

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