Struct rusty_v8::EscapableHandleScope

pub struct EscapableHandleScope<'s, 'e: 's, C = Context> { /* fields omitted */ }

A HandleScope which first allocates a handle in the current scope which will be later filled with the escape value.

Implementations

impl<'s, 'e: 's> EscapableHandleScope<'s, 'e>

pub fn new<P: NewEscapableHandleScope<'s, 'e>>(param: &'s mut P) -> P::NewScope

impl<'s, 'e: 's, C> EscapableHandleScope<'s, 'e, C>

pub fn escape<T>(&mut self, value: Local<'_, T>) -> Local<'e, T> where
    for<'l> Local<'l, T>: Into<Local<'l, Data>>, 

Pushes the value into the previous scope and returns a handle to it. Cannot be called twice.

Methods from Deref<Target = HandleScope<'s, ()>>

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.

pub fn get_entered_or_microtask_context(&self) -> Local<'s, 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.

pub fn throw_exception(
    &mut self,
    exception: Local<'_, Value>
) -> Local<'s, 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.

pub fn get_isolate_data_from_snapshot_once<T>(
    &mut self,
    index: usize
) -> Result<Local<'s, T>, DataError> where
    T: 'static,
    for<'l> Local<'l, Data>: TryInto<Local<'l, T>, Error = 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.

pub fn get_context_data_from_snapshot_once<T>(
    &mut self,
    index: usize
) -> Result<Local<'s, T>, DataError> where
    T: 'static,
    for<'l> Local<'l, Data>: TryInto<Local<'l, T>, Error = 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.

Trait Implementations

impl<'s, 'p, 'e> AsMut<EscapableHandleScope<'p, 'e, ()>> for ContextScope<'s, EscapableHandleScope<'p, 'e>>

fn as_mut(&mut self) -> &mut EscapableHandleScope<'p, 'e, ()>

Performs the conversion.

impl<'s, 'p, 'e, C> AsMut<EscapableHandleScope<'p, 'e, ()>> for TryCatch<'s, EscapableHandleScope<'p, 'e, C>>

fn as_mut(&mut self) -> &mut EscapableHandleScope<'p, 'e, ()>

Performs the conversion.

impl<'s, 'p, 'e> AsMut<EscapableHandleScope<'p, 'e, Context>> for ContextScope<'s, EscapableHandleScope<'p, 'e>>

fn as_mut(&mut self) -> &mut EscapableHandleScope<'p, 'e>

Performs the conversion.

impl<'s, 'p, 'e> AsMut<EscapableHandleScope<'p, 'e, Context>> for TryCatch<'s, EscapableHandleScope<'p, 'e>>

fn as_mut(&mut self) -> &mut EscapableHandleScope<'p, 'e>

Performs the conversion.

impl<'s, 'e, C> AsMut<EscapableHandleScope<'s, 'e, ()>> for EscapableHandleScope<'s, 'e, C>

fn as_mut(&mut self) -> &mut EscapableHandleScope<'s, 'e, ()>

Performs the conversion.

impl<'s, 'e> AsMut<EscapableHandleScope<'s, 'e, Context>> for EscapableHandleScope<'s, 'e>

fn as_mut(&mut self) -> &mut EscapableHandleScope<'s, 'e>

Performs the conversion.

impl<'s, 'e, C> AsMut<HandleScope<'s, ()>> for EscapableHandleScope<'s, 'e, C>

fn as_mut(&mut self) -> &mut HandleScope<'s, ()>

Performs the conversion.

impl<'s, 'e> AsMut<HandleScope<'s, Context>> for EscapableHandleScope<'s, 'e>

fn as_mut(&mut self) -> &mut HandleScope<'s>

Performs the conversion.

impl<'s, 'e, C> AsMut<Isolate> for EscapableHandleScope<'s, 'e, C>

fn as_mut(&mut self) -> &mut Isolate

Performs the conversion.

impl<'s, 'p, 'e> AsRef<EscapableHandleScope<'p, 'e, ()>> for ContextScope<'s, EscapableHandleScope<'p, 'e>>

fn as_ref(&self) -> &EscapableHandleScope<'p, 'e, ()>

Performs the conversion.

impl<'s, 'p, 'e, C> AsRef<EscapableHandleScope<'p, 'e, ()>> for TryCatch<'s, EscapableHandleScope<'p, 'e, C>>

fn as_ref(&self) -> &EscapableHandleScope<'p, 'e, ()>

Performs the conversion.

impl<'s, 'p, 'e> AsRef<EscapableHandleScope<'p, 'e, Context>> for ContextScope<'s, EscapableHandleScope<'p, 'e>>

fn as_ref(&self) -> &EscapableHandleScope<'p, 'e>

Performs the conversion.

impl<'s, 'p, 'e> AsRef<EscapableHandleScope<'p, 'e, Context>> for TryCatch<'s, EscapableHandleScope<'p, 'e>>

fn as_ref(&self) -> &EscapableHandleScope<'p, 'e>

Performs the conversion.

impl<'s, 'e, C> AsRef<EscapableHandleScope<'s, 'e, ()>> for EscapableHandleScope<'s, 'e, C>

fn as_ref(&self) -> &EscapableHandleScope<'s, 'e, ()>

Performs the conversion.

impl<'s, 'e> AsRef<EscapableHandleScope<'s, 'e, Context>> for EscapableHandleScope<'s, 'e>

fn as_ref(&self) -> &EscapableHandleScope<'s, 'e>

Performs the conversion.

impl<'s, 'e, C> AsRef<HandleScope<'s, ()>> for EscapableHandleScope<'s, 'e, C>

fn as_ref(&self) -> &HandleScope<'s, ()>

Performs the conversion.

impl<'s, 'e> AsRef<HandleScope<'s, Context>> for EscapableHandleScope<'s, 'e>

fn as_ref(&self) -> &HandleScope<'s>

Performs the conversion.

impl<'s, 'e, C> AsRef<Isolate> for EscapableHandleScope<'s, 'e, C>

fn as_ref(&self) -> &Isolate

Performs the conversion.

impl<'s, 'e: 's, C: Debug> Debug for EscapableHandleScope<'s, 'e, C>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'s, 'e> Deref for EscapableHandleScope<'s, 'e, ()>

type Target = HandleScope<'s, ()>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'s, 'e> Deref for EscapableHandleScope<'s, 'e>

type Target = HandleScope<'s>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'s, 'e> DerefMut for EscapableHandleScope<'s, 'e, ()>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'s, 'e> DerefMut for EscapableHandleScope<'s, 'e>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'s, 'e, C> Drop for EscapableHandleScope<'s, 'e, C>

fn drop(&mut self)

Executes the destructor for this type.