#include <v8-exception.h>
An external exception handler.
Definition at line 138 of file v8-exception.h.
◆ TryCatch() [1/2]
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 2730 of file api.cc.
◆ ~TryCatch()
| v8::TryCatch::~TryCatch |
( |
| ) |
|
Unregisters and deletes this try/catch block.
Definition at line 2752 of file api.cc.
◆ TryCatch() [2/2]
| v8::TryCatch::TryCatch |
( |
const TryCatch & | | ) |
|
|
delete |
◆ CanContinue()
| bool v8::TryCatch::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 2785 of file api.cc.
◆ Exception()
Returns the exception caught by this try/catch block. If no exception has been caught an empty handle is returned.
Definition at line 2798 of file api.cc.
◆ HasCaught()
| bool v8::TryCatch::HasCaught |
( |
| ) |
const |
Returns true if an exception has been caught by this try/catch block.
Definition at line 2781 of file api.cc.
◆ HasTerminated()
| bool v8::TryCatch::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 2787 of file api.cc.
◆ IsVerbose()
| bool v8::TryCatch::IsVerbose |
( |
| ) |
const |
Returns true if verbosity is enabled.
Definition at line 2858 of file api.cc.
◆ JSStackComparableAddressPrivate()
There are cases when the raw address of C++ TryCatch object cannot be used for comparisons with addresses into the JS stack. The cases are: 1) ARM, ARM64 and MIPS simulators which have separate JS stack. 2) Address sanitizer allocates local C++ object in the heap when UseAfterReturn mode is enabled. This method returns address that can be used for comparisons with addresses into the JS stack. When neither simulator nor ASAN's UseAfterReturn is enabled, then the address returned will be the address of the C++ try catch handler itself.
Definition at line 273 of file v8-exception.h.
◆ Message()
Returns the message associated with this exception. If there is no message associated an empty handle is returned.
Definition at line 2829 of file api.cc.
◆ operator delete()
| void v8::TryCatch::operator delete |
( |
void * | , |
|
|
size_t | ) |
|
private |
◆ operator delete[]()
| void v8::TryCatch::operator delete[] |
( |
void * | , |
|
|
size_t | ) |
|
private |
◆ operator new()
| void * v8::TryCatch::operator new |
( |
size_t | size | ) |
|
|
private |
◆ operator new[]()
| void * v8::TryCatch::operator new[] |
( |
size_t | size | ) |
|
|
private |
◆ operator=()
| void v8::TryCatch::operator= |
( |
const TryCatch & | | ) |
|
|
delete |
◆ Reset()
| void v8::TryCatch::Reset |
( |
| ) |
|
Clears any exceptions that may have been caught by this try/catch block. After this method has been called, HasCaught() will return false. Cancels the scheduled exception if it is caught and ReThrow() is not called before.
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 2839 of file api.cc.
◆ ResetInternal()
| void v8::TryCatch::ResetInternal |
( |
| ) |
|
|
private |
◆ 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 2792 of file api.cc.
◆ SetCaptureMessage()
| void v8::TryCatch::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 2860 of file api.cc.
◆ SetVerbose()
| void v8::TryCatch::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 2856 of file api.cc.
◆ StackTrace() [1/2]
Returns the .stack property of the thrown object. If no .stack property is present or if this try/catch block has not caught an exception, an empty handle is returned.
Definition at line 2824 of file api.cc.
◆ StackTrace() [2/2]
Returns the .stack property of an object. If no .stack property is present an empty handle is returned.
Definition at line 2806 of file api.cc.
◆ internal::Isolate
◆ internal::ThreadLocalTop
◆ can_continue_
| bool v8::TryCatch::can_continue_ |
|
private |
◆ capture_message_
| bool v8::TryCatch::capture_message_ |
|
private |
◆ exception_
| void* v8::TryCatch::exception_ |
|
private |
◆ i_isolate_
◆ is_verbose_
| bool v8::TryCatch::is_verbose_ |
|
private |
◆ js_stack_comparable_address_
◆ message_obj_
| void* v8::TryCatch::message_obj_ |
|
private |
◆ next_
◆ rethrow_
| bool v8::TryCatch::rethrow_ |
|
private |
The documentation for this class was generated from the following files:
1.12.0