 |
v8
3.25.30(node0.11.13)
V8 is Google's open source JavaScript engine
|
|
v8
3.25.30(node0.11.13)
V8 is Google's open source JavaScript engine
|
#include <v8.h>
Public Member Functions | |
| TryCatch () | |
| ~TryCatch () | |
| bool | HasCaught () const |
| bool | CanContinue () const |
| bool | HasTerminated () const |
| Handle< Value > | ReThrow () |
| Local< Value > | Exception () const |
| Local< Value > | StackTrace () const |
| Local< v8::Message > | Message () const |
| void | Reset () |
| void | SetVerbose (bool value) |
| void | SetCaptureMessage (bool value) |
Friends | |
| class | v8::internal::Isolate |
| TryCatch | ( | ) |
Creates a new try/catch block and registers it with v8. Note that all TryCatch blocks should be stack allocated because the memory location itself is compared against JavaScript try/catch blocks.
Definition at line 1865 of file api.cc.
References Isolate::RegisterTryCatchHandler(), and TryCatch::Reset().
| ~TryCatch | ( | ) |
Unregisters and deletes this try/catch block.
Definition at line 1878 of file api.cc.
References ASSERT, v8::Exception, and Local< T >::New().
| bool CanContinue | ( | ) | const |
For certain types of exceptions, it makes no sense to continue execution.
If CanContinue returns false, the correct action is to perform any C++ cleanup needed and then return. If CanContinue returns false and HasTerminated returns true, it is possible to call CancelTerminateExecution in order to continue calling into the engine.
Definition at line 1906 of file api.cc.
Referenced by DoLoop(), DoLoopCancelTerminate(), DoLoopNoCall(), LoopGetProperty(), and ReenterAfterTermination().
Returns the exception caught by this try/catch block. If no exception has been caught an empty handle is returned.
The returned handle is valid until this TryCatch block has been destroyed.
Definition at line 1923 of file api.cc.
References ASSERT, and Utils::ToLocal().
Referenced by DeclarationContext::Check(), DoLoop(), DoLoopCancelTerminate(), DoLoopNoCall(), LoopGetProperty(), JsHttpRequestProcessor::Process(), ReenterAfterTermination(), ReportException(), Shell::ReportException(), TEST(), THREADED_PROFILED_TEST(), THREADED_TEST(), and Execution::TryCall().
| bool HasCaught | ( | ) | const |
Returns true if an exception has been caught by this try/catch block.
Definition at line 1901 of file api.cc.
Referenced by DeclarationContext::Check(), CThrowCountDown(), DoLoop(), DoLoopCancelTerminate(), DoLoopNoCall(), ExecuteString(), Shell::ExecuteString(), LoopGetProperty(), main(), ReenterAfterTermination(), Isolate::RestorePendingMessageFromTryCatch(), RunCppCycle(), RunMain(), TEST(), THREADED_PROFILED_TEST(), THREADED_TEST(), Execution::TryCall(), TryCatchMixedNestingCheck(), TryCatchMixedNestingHelper(), and Shell::Write().
| bool HasTerminated | ( | ) | const |
Returns true if an exception has been caught due to script execution being terminated.
There is no JavaScript representation of an execution termination exception. Such exceptions are thrown when the TerminateExecution methods are called to terminate a long-running script.
If such an exception has been thrown, HasTerminated will return true, indicating that it is possible to call CancelTerminateExecution in order to continue calling into the engine.
Definition at line 1911 of file api.cc.
Referenced by DoLoopCancelTerminate(), and TEST().
| v8::Local< v8::Message > Message | ( | ) | const |
Returns the message associated with this exception. If there is no message associated an empty handle is returned.
The returned handle is valid until this TryCatch block has been destroyed.
Definition at line 1953 of file api.cc.
References ASSERT, and Utils::MessageToLocal().
Referenced by DoLoop(), DoLoopCancelTerminate(), DoLoopNoCall(), LoopGetProperty(), main(), ReenterAfterTermination(), ReportException(), Shell::ReportException(), TEST(), and TryCatchMixedNestingCheck().
| void Reset | ( | ) |
Clears any exceptions that may have been caught by this try/catch block. After this method has been called, HasCaught() will return false.
It is not necessary to clear a try/catch block before using it again; if another exception is thrown the previously caught exception will just be overwritten. However, it is often a good idea since it makes it easier to determine which operation threw a given exception.
Definition at line 1965 of file api.cc.
References ASSERT.
Referenced by TEST(), THREADED_TEST(), and TryCatch::TryCatch().
| v8::Handle< v8::Value > ReThrow | ( | ) |
Throws the exception caught by this TryCatch in a way that avoids it being caught again by this same TryCatch. As with ThrowException it is illegal to execute any JavaScript operations after calling ReThrow; the caller must return immediately to where the exception is caught.
Definition at line 1916 of file api.cc.
References v8::Undefined().
Referenced by TryCatchMixedNestingHelper(), and Shell::Write().
| void SetCaptureMessage | ( | bool | value | ) |
Set whether or not this TryCatch should capture a Message object which holds source information about where the exception occurred. True by default.
Definition at line 1981 of file api.cc.
Referenced by Execution::TryCall().
| void SetVerbose | ( | bool | value | ) |
Set verbosity of the external exception handler.
By default, exceptions that are caught by an external exception handler are not reported. Call SetVerbose with true on an external exception handler to have exceptions caught by the handler reported as if they were not caught.
Definition at line 1976 of file api.cc.
Referenced by DeclarationContext::Check(), SimpleContext::Check(), Shell::ExecuteString(), TEST(), and Execution::TryCall().
| v8::Local< Value > StackTrace | ( | ) | const |
Returns the .stack property of the thrown object. If no .stack property is present an empty handle is returned.
Definition at line 1935 of file api.cc.
References ASSERT, JSObject::cast(), HandleScope::CloseAndEscape(), v8::internal::GetProperty(), JSReceiver::HasProperty(), obj, and Utils::ToLocal().
Referenced by ReportException(), Shell::ReportException(), and TEST().
|
friend |
1.8.6 
