Throwing a JavaScript exception from C++ code using Google V8

javascript c++ v8
Etan picture Etan · Sep 2, 2009 · Viewed 7.3k times · Source

I'm programming a JavaScript application which accesses some C++ code over Google's V8.

Everything works fine, but I couldn't figure out how I can throw a JavaScript exception which can be catched in the JavaScript code from the C++ method.

For example, if I have a function in C++ like

...
using namespace std;
using namespace v8;
...
static Handle<Value> jsHello(const Arguments& args) {
    String::Utf8Value input(args[0]);
    if (input == "Hello") {
        string result = "world";
        return String::New(result.c_str());
    } else {
        // throw exception
    }
}
...
    global->Set(String::New("hello"), FunctionTemplate::New(jsHello));
    Persistent<Context> context = Context::New(NULL, global);
...

exposed to JavaScript, I'ld like to use it in the JavaScript code like

try {
    hello("throw me some exception!");
} catch (e) {
    // catched it!
}

What is the correct way to throw a V8-exception out of the C++ code?

Answer

Matthew Crumley picture Matthew Crumley · Sep 2, 2009

Edit: This answer is for older versions of V8. For current versions, see Sutarmin Anton's Answer.

return v8::ThrowException(v8::String::New("Exception message"));

You can also throw a more specific exception with the static functions in v8::Exception:

return v8::ThrowException(v8::Exception::RangeError(v8::String::New("...")));
return v8::ThrowException(v8::Exception::ReferenceError(v8::String::New("...")));
return v8::ThrowException(v8::Exception::SyntaxError(v8::String::New("...")));
return v8::ThrowException(v8::Exception::TypeError(v8::String::New("...")));
return v8::ThrowException(v8::Exception::Error(v8::String::New("...")));

Related questions

How do you expose a C++ class in the V8 Javascript Engine so it can be created using new?

The official examples of exposing a Point class seem to assume that there will be a fixed number of instances of it in your program. It is not clear how new instances are allocated in the C++ code, when new …

Read More
Compile JavaScript to Native Code with V8

Is it really possible, with Google's V8 Engine, to compile JavaScript into Native Code, save it as a binary file, and execute it whenever I want through my software envorinment, on any machine?

Read More
Nodejs: What does `process.binding` mean?

I've seen process.binding('...') many times while researching through the node.js source code on github. Can anybody explain me what this function does?

Read More