Struct josephine::context::JSContext

pub struct JSContext<S> { /* fields omitted */ }

The type for JS contexts whose current state is S.

Methods

impl JSContext<Owned>

fn new() -> Result<JSContext<Owned>, ()>

Create a new JSContext.

impl<S> JSContext<S>

fn snapshot<'a>(&'a mut self) -> JSContext<Snapshotted<'a, S>>

Get a snapshot of the JS state. The snapshot only allows access to the methods that are guaranteed not to call GC, so we don't need to root JS-managed pointers during the lifetime of a snapshot.

fn enter_known_compartment<'a, 'b, C, T>(
    &'a mut self,
    managed: JSManaged<'b, C, T>
) -> JSContext<Entered<'a, C, T::Aged, S>> where
    T: JSLifetime<'a>,
    C: Compartment, 

Enter a known compartment.

fn enter_unknown_compartment<'a, 'b, C, T>(
    &'a mut self,
    managed: JSManaged<'b, C, T>
) -> JSContext<Entered<'a, BOUND<'a>, T::Aged, S>> where
    T: JSLifetime<'a>, 

Enter a compartment.

fn manage<'a, C, T>(&'a mut self, value: T) -> JSManaged<'a, C, T::Aged> where
    S: CanAlloc + InCompartment<C>,
    C: Compartment,
    T: JSTraceable + JSInitializable + JSLifetime<'a>, 

Give ownership of data to JS. This allocates JS heap, which may trigger GC.

fn snapshot_manage<'a, C, T>(
    &'a mut self,
    value: T
) -> (JSContext<Snapshotted<'a, S>>, JSManaged<'a, C, T::Aged>) where
    S: CanAlloc + InCompartment<C>,
    C: Compartment,
    T: JSTraceable + JSInitializable + JSLifetime<'a>, 

Give ownership of data to JS. This allocates JS heap, which may trigger GC.

fn create_compartment<'a, T>(
    &'a mut self
) -> JSContext<Initializing<'a, BOUND<'a>, T>> where
    S: CanAlloc + CanAccess,
    T: JSInitializable + JSTraceable, 

Create a compartment

fn global_manage<'a, C, T>(
    self,
    value: T
) -> JSContext<Initialized<'a, C, T::Aged>> where
    S: IsInitializing<'a, C, T>,
    T: JSTraceable + JSLifetime<'a> + JSCompartmental<C, C, ChangeCompartment = T>, 

Finish initializing a JS Context

fn entered<'a, C, T>(&self) -> JSManaged<'a, C, T> where
    S: IsEntered<'a, C, T>, 

Get the object we entered the current compartment via

fn global<'a, C, T>(&self) -> JSManaged<'a, C, T> where
    S: IsInitialized<'a, C, T>, 

Get the global of an initialized context.

fn new_root<'a, 'b, T>(&'b mut self) -> JSRoot<'a, T>

Create a new root.

fn cx(&self) -> *mut JSContext

fn rt(&self) -> *mut JSRuntime

fn gc(&mut self) where
    S: CanAlloc, 

fn prototype_of<T>(&mut self) -> Handle<*mut JSObject> where
    T: JSInitializable, 

fn evaluate<C>(&mut self, code: &str) -> Result<Value, JSEvaluateErr> where
    S: InCompartment<C>, 

fn take_pending_exception(&mut self) -> Result<(), JSEvaluateErr>