TryCatch Class Reference

#include <v8.h>

Public Member Functions
	TryCatch ()
	~TryCatch ()
bool	HasCaught () const
bool	CanContinue () 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

Detailed Description

An external exception handler.

Definition at line 3354 of file v8.h.

Constructor & Destructor Documentation

TryCatch

(

)

Creates a new try/catch block and registers it with v8.

Definition at line 1669 of file api.cc.

References Isolate::RegisterTryCatchHandler().

~TryCatch

(

)

Unregisters and deletes this try/catch block.

Definition at line 1682 of file api.cc.

References ASSERT, v8::Exception, Local< T >::New(), and v8::ThrowException().

Member Function Documentation

bool CanContinue

(

)

const

For certain types of exceptions, it makes no sense to continue execution.

Currently, the only type of exception that can be caught by a TryCatch handler and for which it does not make sense to continue is termination exception. Such exceptions are thrown when the TerminateExecution methods are called to terminate a long-running script.

If CanContinue returns false, the correct action is to perform any C++ cleanup needed and then return.

Definition at line 1700 of file api.cc.

Referenced by DoLoop(), DoLoopNoCall(), LoopGetProperty(), and ReenterAfterTermination().

v8::Local< Value > Exception

(

)

const

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 1712 of file api.cc.

References ASSERT, and Utils::ToLocal().

Referenced by DeclarationContext::Check(), DoLoop(), DoLoopNoCall(), LoopGetProperty(), JsHttpRequestProcessor::Process(), ReenterAfterTermination(), ReportException(), Shell::ReportException(), 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 1695 of file api.cc.

Referenced by CCatcher(), DeclarationContext::Check(), CThrowCountDown(), DoLoop(), DoLoopNoCall(), ExecuteString(), Shell::ExecuteString(), LoopGetProperty(), ReenterAfterTermination(), RunCppCycle(), RunMain(), TEST(), THREADED_TEST(), and Execution::TryCall().

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 1742 of file api.cc.

References ASSERT, Smi::FromInt(), and Utils::MessageToLocal().

Referenced by DoLoop(), DoLoopNoCall(), LoopGetProperty(), ReenterAfterTermination(), ReportException(), Shell::ReportException(), and TEST().

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 1753 of file api.cc.

References ASSERT, and Smi::FromInt().

Referenced by TEST(), and THREADED_TEST().

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 1705 of file api.cc.

References v8::Undefined().

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 1765 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 1760 of file api.cc.

Referenced by DeclarationContext::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 1724 of file api.cc.

References ASSERT, JSObject::cast(), HandleScope::CloseAndEscape(), v8::internal::GetProperty(), Handle< T >::is_null(), and Utils::ToLocal().

Referenced by ReportException(), Shell::ReportException(), and THREADED_TEST().

Friends And Related Function Documentation

friend class v8::internal::Isolate

friend

Definition at line 3456 of file v8.h.

---

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

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