v8::Message Class Reference

An error message. More...

#include <v8.h>

Collaboration diagram for v8::Message:

Public Member Functions
Local< String >	Get () const
Local< String >	GetSourceLine () const
ScriptOrigin	GetScriptOrigin () const
	Returns the origin for the script from where the function causing the error originates. More...
Handle< Value >	GetScriptResourceName () const
	Returns the resource name for the script from where the function causing the error originates. More...
Handle< StackTrace >	GetStackTrace () const
	Exception stack trace. More...
int	GetLineNumber () const
	Returns the number, 1-based, of the line where the error occurred. More...
int	GetStartPosition () const
	Returns the index within the script of the first character where the error occurred. More...
int	GetEndPosition () const
	Returns the index within the script of the last character where the error occurred. More...
int	GetStartColumn () const
	Returns the index within the line of the first character where the error occurred. More...
int	GetEndColumn () const
	Returns the index within the line of the last character where the error occurred. More...
bool	IsSharedCrossOrigin () const
	Passes on the value set by the embedder when it fed the script from which this Message was generated to V8. More...

Static Public Member Functions
static void	PrintCurrentStackTrace (Isolate *isolate, FILE *out)

Static Public Attributes
static const int	kNoLineNumberInfo = 0
static const int	kNoColumnInfo = 0
static const int	kNoScriptIdInfo = 0

Detailed Description

An error message.

Definition at line 1233 of file v8.h.

Member Function Documentation

Get()

Local< String > v8::Message::Get

(

)

const

Definition at line 2059 of file api.cc.

                                 {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ON_BAILOUT(isolate, "v8::Message::Get()", return Local<String>());
  ENTER_V8(isolate);
  EscapableHandleScope scope(reinterpret_cast<Isolate*>(isolate));
  i::Handle<i::Object> obj = Utils::OpenHandle(this);
  i::Handle<i::String> raw_result = i::MessageHandler::GetMessage(isolate, obj);
  Local<String> result = Utils::ToLocal(raw_result);
  return scope.Escape(result);
}

References ENTER_V8, v8::EscapableHandleScope::Escape(), v8::internal::MessageHandler::GetMessage(), ON_BAILOUT, v8::Utils::OpenHandle(), and v8::Utils::ToLocal().

Here is the call graph for this function:

GetEndColumn()

int v8::Message::GetEndColumn

(

)

const

Returns the index within the line of the last character where the error occurred.

Definition at line 2187 of file api.cc.

                                {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ON_BAILOUT(isolate, "v8::Message::GetEndColumn()", return kNoColumnInfo);
  ENTER_V8(isolate);
  i::HandleScope scope(isolate);
  i::Handle<i::JSObject> data_obj = Utils::OpenHandle(this);
  EXCEPTION_PREAMBLE(isolate);
  i::Handle<i::Object> start_col_obj;
  has_pending_exception = !CallV8HeapFunction(
      "GetPositionInLine", data_obj).ToHandle(&start_col_obj);
  EXCEPTION_BAILOUT_CHECK(isolate, 0);
  i::Handle<i::JSMessageObject> message =
      i::Handle<i::JSMessageObject>::cast(data_obj);
  int start = message->start_position();
  int end = message->end_position();
  return static_cast<int>(start_col_obj->Number()) + (end - start);
}

References v8::CallV8HeapFunction(), v8::internal::Handle< T >::cast(), ENTER_V8, EXCEPTION_BAILOUT_CHECK, EXCEPTION_PREAMBLE, kNoColumnInfo, ON_BAILOUT, and v8::Utils::OpenHandle().

Here is the call graph for this function:

GetEndPosition()

int v8::Message::GetEndPosition

(

)

const

Returns the index within the script of the last character where the error occurred.

Definition at line 2162 of file api.cc.

                                  {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ENTER_V8(isolate);
  i::HandleScope scope(isolate);
  i::Handle<i::JSMessageObject> message =
      i::Handle<i::JSMessageObject>::cast(Utils::OpenHandle(this));
  return message->end_position();
}

References v8::internal::Handle< T >::cast(), ENTER_V8, and v8::Utils::OpenHandle().

Here is the call graph for this function:

GetLineNumber()

int v8::Message::GetLineNumber

(

)

const

Returns the number, 1-based, of the line where the error occurred.

Definition at line 2137 of file api.cc.

                                 {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ON_BAILOUT(isolate, "v8::Message::GetLineNumber()", return kNoLineNumberInfo);
  ENTER_V8(isolate);
  i::HandleScope scope(isolate);
 
  EXCEPTION_PREAMBLE(isolate);
  i::Handle<i::Object> result;
  has_pending_exception = !CallV8HeapFunction(
      "GetLineNumber", Utils::OpenHandle(this)).ToHandle(&result);
  EXCEPTION_BAILOUT_CHECK(isolate, 0);
  return static_cast<int>(result->Number());
}

References v8::CallV8HeapFunction(), ENTER_V8, EXCEPTION_BAILOUT_CHECK, EXCEPTION_PREAMBLE, kNoLineNumberInfo, ON_BAILOUT, and v8::Utils::OpenHandle().

Here is the call graph for this function:

GetScriptOrigin()

ScriptOrigin v8::Message::GetScriptOrigin

(

)

const

Returns the origin for the script from where the function causing the error originates.

Definition at line 2071 of file api.cc.

                                            {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  i::Handle<i::JSMessageObject> message =
      i::Handle<i::JSMessageObject>::cast(Utils::OpenHandle(this));
  i::Handle<i::Object> script_wraper =
      i::Handle<i::Object>(message->script(), isolate);
  i::Handle<i::JSValue> script_value =
      i::Handle<i::JSValue>::cast(script_wraper);
  i::Handle<i::Script> script(i::Script::cast(script_value->value()));
  i::Handle<i::Object> scriptName(i::Script::GetNameOrSourceURL(script));
  v8::Isolate* v8_isolate =
      reinterpret_cast<v8::Isolate*>(script->GetIsolate());
  v8::ScriptOrigin origin(
      Utils::ToLocal(scriptName),
      v8::Integer::New(v8_isolate, script->line_offset()->value()),
      v8::Integer::New(v8_isolate, script->column_offset()->value()),
      Handle<Boolean>(),
      v8::Integer::New(v8_isolate, script->id()->value()));
  return origin;
}

References v8::internal::Handle< T >::cast(), v8::internal::Script::GetNameOrSourceURL(), v8::Integer::New(), v8::Utils::OpenHandle(), and v8::Utils::ToLocal().

Referenced by GetScriptResourceName().

Here is the call graph for this function:

Here is the caller graph for this function:

GetScriptResourceName()

v8::Handle< Value > v8::Message::GetScriptResourceName

(

)

const

Returns the resource name for the script from where the function causing the error originates.

Definition at line 2093 of file api.cc.

                                                     {
  return GetScriptOrigin().ResourceName();
}

References GetScriptOrigin(), and v8::ScriptOrigin::ResourceName().

Here is the call graph for this function:

GetSourceLine()

Local< String > v8::Message::GetSourceLine

(

)

const

Definition at line 2219 of file api.cc.

                                           {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ON_BAILOUT(isolate, "v8::Message::GetSourceLine()", return Local<String>());
  ENTER_V8(isolate);
  EscapableHandleScope scope(reinterpret_cast<Isolate*>(isolate));
  EXCEPTION_PREAMBLE(isolate);
  i::Handle<i::Object> result;
  has_pending_exception = !CallV8HeapFunction(
      "GetSourceLine", Utils::OpenHandle(this)).ToHandle(&result);
  EXCEPTION_BAILOUT_CHECK(isolate, Local<v8::String>());
  if (result->IsString()) {
    return scope.Escape(Utils::ToLocal(i::Handle<i::String>::cast(result)));
  } else {
    return Local<String>();
  }
}

References v8::CallV8HeapFunction(), ENTER_V8, v8::EscapableHandleScope::Escape(), EXCEPTION_BAILOUT_CHECK, EXCEPTION_PREAMBLE, ON_BAILOUT, v8::Utils::OpenHandle(), and v8::Utils::ToLocal().

Here is the call graph for this function:

GetStackTrace()

v8::Handle< v8::StackTrace > v8::Message::GetStackTrace

(

)

const

Exception stack trace.

By default stack traces are not captured for uncaught exceptions. SetCaptureStackTraceForUncaughtExceptions allows to change this option.

Definition at line 2098 of file api.cc.

                                                    {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ENTER_V8(isolate);
  EscapableHandleScope scope(reinterpret_cast<Isolate*>(isolate));
  i::Handle<i::JSMessageObject> message =
      i::Handle<i::JSMessageObject>::cast(Utils::OpenHandle(this));
  i::Handle<i::Object> stackFramesObj(message->stack_frames(), isolate);
  if (!stackFramesObj->IsJSArray()) return v8::Handle<v8::StackTrace>();
  i::Handle<i::JSArray> stackTrace =
      i::Handle<i::JSArray>::cast(stackFramesObj);
  return scope.Escape(Utils::StackTraceToLocal(stackTrace));
}

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

Here is the call graph for this function:

GetStartColumn()

int v8::Message::GetStartColumn

(

)

const

Returns the index within the line of the first character where the error occurred.

Definition at line 2172 of file api.cc.

                                  {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ON_BAILOUT(isolate, "v8::Message::GetStartColumn()", return kNoColumnInfo);
  ENTER_V8(isolate);
  i::HandleScope scope(isolate);
  i::Handle<i::JSObject> data_obj = Utils::OpenHandle(this);
  EXCEPTION_PREAMBLE(isolate);
  i::Handle<i::Object> start_col_obj;
  has_pending_exception = !CallV8HeapFunction(
      "GetPositionInLine", data_obj).ToHandle(&start_col_obj);
  EXCEPTION_BAILOUT_CHECK(isolate, 0);
  return static_cast<int>(start_col_obj->Number());
}

References v8::CallV8HeapFunction(), ENTER_V8, EXCEPTION_BAILOUT_CHECK, EXCEPTION_PREAMBLE, kNoColumnInfo, ON_BAILOUT, and v8::Utils::OpenHandle().

Here is the call graph for this function:

GetStartPosition()

int v8::Message::GetStartPosition

(

)

const

Returns the index within the script of the first character where the error occurred.

Definition at line 2152 of file api.cc.

                                    {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ENTER_V8(isolate);
  i::HandleScope scope(isolate);
  i::Handle<i::JSMessageObject> message =
      i::Handle<i::JSMessageObject>::cast(Utils::OpenHandle(this));
  return message->start_position();
}

References v8::internal::Handle< T >::cast(), ENTER_V8, and v8::Utils::OpenHandle().

Here is the call graph for this function:

IsSharedCrossOrigin()

bool v8::Message::IsSharedCrossOrigin

(

)

const

Passes on the value set by the embedder when it fed the script from which this Message was generated to V8.

Definition at line 2206 of file api.cc.

                                        {
  i::Isolate* isolate = Utils::OpenHandle(this)->GetIsolate();
  ENTER_V8(isolate);
  i::HandleScope scope(isolate);
  i::Handle<i::JSMessageObject> message =
      i::Handle<i::JSMessageObject>::cast(Utils::OpenHandle(this));
  i::Handle<i::JSValue> script =
      i::Handle<i::JSValue>::cast(i::Handle<i::Object>(message->script(),
                                                       isolate));
  return i::Script::cast(script->value())->is_shared_cross_origin();
}

References v8::internal::Handle< T >::cast(), ENTER_V8, and v8::Utils::OpenHandle().

Here is the call graph for this function:

PrintCurrentStackTrace()

void v8::Message::PrintCurrentStackTrace ( Isolate *  isolate, FILE *  out  )

static

Definition at line 2237 of file api.cc.

                                                                {
  i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate);
  ENTER_V8(i_isolate);
  i_isolate->PrintCurrentStackTrace(out);
}

References ENTER_V8, and v8::internal::Isolate::PrintCurrentStackTrace().

Here is the call graph for this function:

Member Data Documentation

kNoColumnInfo

const int v8::Message::kNoColumnInfo = 0

static

Definition at line 1296 of file v8.h.

Referenced by v8::StackFrame::GetColumn(), GetEndColumn(), and GetStartColumn().

kNoLineNumberInfo

const int v8::Message::kNoLineNumberInfo = 0

static

Definition at line 1295 of file v8.h.

Referenced by GetLineNumber(), and v8::StackFrame::GetLineNumber().

kNoScriptIdInfo

const int v8::Message::kNoScriptIdInfo = 0

static

Definition at line 1297 of file v8.h.

Referenced by v8::StackFrame::GetScriptId().

---

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

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