pub struct PinnedRef<'p, T>(/* private fields */);Implementations§
Source§impl<'s> PinnedRef<'s, HandleScope<'_>>
impl<'s> PinnedRef<'s, HandleScope<'_>>
Sourcepub fn get_current_context(&self) -> Local<'s, Context>
pub fn get_current_context(&self) -> Local<'s, Context>
Returns the context of the currently running JavaScript, or the context on the top of the stack if no JavaScript is running
Sourcepub fn get_entered_or_microtask_context(&self) -> Local<'_, Context>
pub fn get_entered_or_microtask_context(&self) -> Local<'_, Context>
Returns either the last context entered through V8’s C++ API, or the context of the currently running microtask while processing microtasks. If a context is entered while executing a microtask, that context is returned.
Sourcepub fn get_isolate_data_from_snapshot_once<T>(
&self,
index: usize,
) -> Result<Local<'s, T>, DataError>
pub fn get_isolate_data_from_snapshot_once<T>( &self, index: usize, ) -> Result<Local<'s, T>, DataError>
Return data that was previously attached to the isolate snapshot via
SnapshotCreator, and removes the reference to it. If called again with
same index argument, this function returns DataError::NoData.
The value that was stored in the snapshot must either match or be
convertible to type parameter T, otherwise DataError::BadType is
returned.
Sourcepub fn get_context_data_from_snapshot_once<T>(
&self,
index: usize,
) -> Result<Local<'s, T>, DataError>
pub fn get_context_data_from_snapshot_once<T>( &self, index: usize, ) -> Result<Local<'s, T>, DataError>
Return data that was previously attached to the context snapshot via
SnapshotCreator, and removes the reference to it. If called again with
same index argument, this function returns DataError::NoData.
The value that was stored in the snapshot must either match or be
convertible to type parameter T, otherwise DataError::BadType is
returned.
pub fn set_promise_hooks( &self, init_hook: Option<Local<'_, Function>>, before_hook: Option<Local<'_, Function>>, after_hook: Option<Local<'_, Function>>, resolve_hook: Option<Local<'_, Function>>, )
pub fn set_continuation_preserved_embedder_data(&self, data: Local<'_, Value>)
pub fn get_continuation_preserved_embedder_data(&self) -> Local<'s, Value>
Sourcepub fn get_current_host_defined_options(&self) -> Option<Local<'s, Data>>
pub fn get_current_host_defined_options(&self) -> Option<Local<'s, Data>>
Returns the host defined options set for currently running script or module, if available.
Source§impl<'p> PinnedRef<'p, HandleScope<'_, ()>>
impl<'p> PinnedRef<'p, HandleScope<'_, ()>>
Sourcepub fn throw_exception(&self, exception: Local<'p, Value>) -> Local<'p, Value>
pub fn throw_exception(&self, exception: Local<'p, Value>) -> Local<'p, Value>
Schedules an exception to be thrown when returning to JavaScript. When an exception has been scheduled it is illegal to invoke any JavaScript operation; the caller must return immediately and only after the exception has been handled does it become legal to invoke JavaScript operations.
This function always returns the undefined value.
Sourcepub unsafe fn unseal<'a, T>(&self, v: SealedLocal<T>) -> Local<'a, T>
pub unsafe fn unseal<'a, T>(&self, v: SealedLocal<T>) -> Local<'a, T>
Source§impl<'scope, 'obj: 'scope, 'iso: 'obj, P: GetIsolate> PinnedRef<'_, TryCatch<'scope, 'obj, P>>
impl<'scope, 'obj: 'scope, 'iso: 'obj, P: GetIsolate> PinnedRef<'_, TryCatch<'scope, 'obj, P>>
Sourcepub fn has_caught(&self) -> bool
pub fn has_caught(&self) -> bool
Returns true if an exception has been caught by this try/catch block.
Sourcepub fn can_continue(&self) -> bool
pub fn can_continue(&self) -> bool
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.
Sourcepub fn has_terminated(&self) -> bool
pub fn has_terminated(&self) -> bool
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.
Sourcepub fn is_verbose(&self) -> bool
pub fn is_verbose(&self) -> bool
Returns true if verbosity is enabled.
Sourcepub fn set_verbose(&mut self, value: bool)
pub fn set_verbose(&mut self, value: bool)
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.
Sourcepub fn set_capture_message(&mut self, value: bool)
pub fn set_capture_message(&mut self, value: bool)
Set whether or not this TryCatch should capture a Message object which holds source information about where the exception occurred. True by default.
Sourcepub fn reset(&mut self)
pub fn reset(&mut self)
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.