Struct rquickjs::Context

pub struct Context(/* private fields */);

A single execution context with its own global variables and stack.

Can share objects with other contexts of the same runtime.

Implementations

impl Context

pub unsafe fn from_raw(ctx: NonNull<JSContext>, rt: Runtime) -> Context

Create a unused context from a raw context pointer.

Safety

Pointer must point to a context from the given runtime. The context must also have valid reference count, one which can be decremented when this object is dropped without going negative.

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

pub fn base(runtime: &Runtime) -> Result<Context, Error>

Creates a base context with only the required functions registered. If additional functions are required use Context::custom, Context::builder or Context::full.

pub fn custom<I>(runtime: &Runtime) -> Result<Context, Error>

where I: Intrinsic,

Creates a context with only the required intrinsics registered. If additional functions are required use Context::custom, Context::builder or Context::full.

pub fn full(runtime: &Runtime) -> Result<Context, Error>

Creates a context with all standard available intrinsics registered. If precise control is required of which functions are available use Context::custom or Context::builder.

pub fn builder() -> ContextBuilder<()>

Create a context builder for creating a context with a specific set of intrinsics

pub fn enable_big_num_ext(&self, enable: bool)

pub fn runtime(&self) -> &Runtime

Returns the associated runtime

pub fn get_runtime_ptr(&self) -> *mut JSRuntime

pub fn with<F, R>(&self, f: F) -> R

where F: FnOnce(Ctx<'_>) -> R,

A entry point for manipulating and using JavaScript objects and scripts. The api is structured this way to avoid repeated locking the runtime when ever any function is called. This way the runtime is locked once before executing the callback. Furthermore, this way it is impossible to use values from different runtimes in this context which would otherwise be undefined behavior.

This is the only way to get a Ctx object.

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Drop for Context

fn drop(&mut self)

Executes the destructor for this type.

impl Send for Context

impl Sync for Context