Struct rquickjs_core::context::Ctx

pub struct Ctx<'js> { /* private fields */ }

Context in use, passed to Context::with.

Implementations

impl<'js> Ctx<'js>

pub unsafe fn from_ptr_invariant( ctx: NonNull<JSContext>, inv: Invariant<'js> ) -> Self

Create a new Ctx from a pointer to the context and a invariant lifetime.

Safety

User must ensure that a lock was acquired over the runtime and that invariant is a unique lifetime which can’t be coerced to a lifetime outside the scope of the lock of to the lifetime of another runtime.

pub fn eval<V: FromJs<'js>, S: Into<Vec<u8>>>(self, source: S) -> Result<V>

Evaluate a script in global context.

pub fn eval_with_options<V: FromJs<'js>, S: Into<Vec<u8>>>( self, source: S, options: EvalOptions ) -> Result<V>

Evaluate a script with the given options.

pub fn eval_file<V: FromJs<'js>, P: AsRef<Path>>(self, path: P) -> Result<V>

Evaluate a script directly from a file.

pub fn eval_file_with_options<V: FromJs<'js>, P: AsRef<Path>>( self, path: P, options: EvalOptions ) -> Result<V>

pub fn compile<N, S>(self, name: N, source: S) -> Result<Module<'js>>where N: Into<Vec<u8>>, S: Into<Vec<u8>>,

Compile a module for later use.

pub fn globals(self) -> Object<'js>

Returns the global object of this context.

pub fn catch(self) -> Value<'js>

Returns the last raised javascript exception, if there is no exception the javascript value null is returned.

Usage

if let Err(Error::Exception) = ctx.eval::<(),_>("throw 3"){
    assert_eq!(ctx.catch().as_int(),Some(3));
}

pub fn throw(self, value: Value<'js>) -> Error

Throws a javascript value as a new exception. Always returns Error::Exception;

pub fn promise(self) -> Result<(Object<'js>, Function<'js>, Function<'js>)>

Creates promise and resolving functions.

pub fn spawn<F>(&self, future: F)where F: Future<Output = ()> + 'js,

Available on crate feature futures only.

Spawn future using configured async runtime

Trait Implementations

impl<'js> Clone for Ctx<'js>

fn clone(&self) -> Ctx<'js>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'js> Debug for Ctx<'js>

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

Formats the value using the given formatter.

impl<'js> Copy for Ctx<'js>

impl Send for Ctx<'_>