Struct rquickjs::Ctx

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

Context in use, passed to Context::with.

Implementations

impl<'js> Ctx<'js>

pub fn eval<V, S>(&self, source: S) -> Result<V, Error>

where V: FromJs<'js>, S: Into<Vec<u8>>,

Evaluate a script in global context.

pub fn eval_promise<S>(&self, source: S) -> Result<Promise<'js>, Error>

where S: Into<Vec<u8>>,

Evaluate a script in global context with top level await support.

This function always returns a promise which resolves to the result of the evaluated expression.

pub fn eval_with_options<V, S>( &self, source: S, options: EvalOptions ) -> Result<V, Error>

where V: FromJs<'js>, S: Into<Vec<u8>>,

Evaluate a script with the given options.

pub fn eval_file<V, P>(&self, path: P) -> Result<V, Error>

where V: FromJs<'js>, P: AsRef<Path>,

Evaluate a script directly from a file.

pub fn eval_file_with_options<V, P>( &self, path: P, options: EvalOptions ) -> Result<V, Error>

where V: FromJs<'js>, P: AsRef<Path>,

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 json_parse<S>(&self, json: S) -> Result<Value<'js>, Error>

where S: Into<Vec<u8>>,

Parse json into a JavaScript value.

pub fn json_parse_ext<S>( &self, json: S, allow_extensions: bool ) -> Result<Value<'js>, Error>

where S: Into<Vec<u8>>,

Parse json into a JavaScript value, possibly allowing extended syntax support.

If allow_extensions is true, this function will allow extended json syntax. Extended syntax allows comments, single quoted strings, non string property names, trailing comma’s and hex, oct and binary numbers.

pub fn json_stringify<V>(&self, value: V) -> Result<Option<String<'js>>, Error>

where V: IntoJs<'js>,

Stringify a JavaScript value into its JSON representation

pub fn json_stringify_replacer<V, R>( &self, value: V, replacer: R ) -> Result<Option<String<'js>>, Error>

where V: IntoJs<'js>, R: IntoJs<'js>,

Stringify a JavaScript value into its JSON representation with a possible replacer.

The replacer is the same as the replacer argument for JSON.stringify. It is is a function that alters the behavior of the stringification process.

pub fn json_stringify_replacer_space<V, R, S>( &self, value: V, replacer: R, space: S ) -> Result<Option<String<'js>>, Error>

where V: IntoJs<'js>, R: IntoJs<'js>, S: IntoJs<'js>,

Stringify a JavaScript value into its JSON representation with a possible replacer and spaces

The replacer is the same as the replacer argument for JSON.stringify. It is is a function that alters the behavior of the stringification process.

Space is either a number or a string which is used to insert whitespace into the output string for readability purposes. This behaves the same as the space argument for JSON.stringify.

pub fn promise( &self ) -> Result<(Promise<'js>, Function<'js>, Function<'js>), Error>

Creates javascipt promise along with its reject and resolve functions.

pub fn execute_pending_job(&self) -> bool

Executes a quickjs job.

Returns wether a job was actually executed. If this function returned false, no job was pending.

pub fn spawn<F>(&self, future: F)

where F: Future<Output = ()> + 'js,

Available on crate feature futures only.

Spawn future using configured async runtime

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

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 unsafe fn from_raw(ctx: NonNull<JSContext>) -> Ctx<'js>

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 script_or_module_name(&self, stack_level: isize) -> Option<Atom<'js>>

pub fn run_gc(&self)

pub fn as_raw(&self) -> NonNull<JSContext>

Returns the pointer to the C library context.

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<(), Error>

Formats the value using the given formatter.

impl<'js> Drop for Ctx<'js>

fn drop(&mut self)

Executes the destructor for this type.

impl<'js> FromParam<'js> for Ctx<'js>

fn param_requirement() -> ParamRequirement

The parameters requirements this value requires.

fn from_param<'a>( params: &mut ParamsAccessor<'a, 'js> ) -> Result<Ctx<'js>, Error>

Convert from a parameter value.

impl<'js> Trace<'js> for Ctx<'js>

fn trace<'a>(&self, tracer: Tracer<'a, 'js>)

impl Send for Ctx<'_>