Struct ModuleContext

pub struct ModuleContext<'cx> { /* private fields */ }

An execution context of module initialization.

Implementations

impl<'cx> ModuleContext<'cx>

pub fn export_function<F, V>(&mut self, key: &str, f: F) -> NeonResult<()>

where F: Fn(FunctionContext<'_>) -> JsResult<'_, V> + 'static, V: Value,

Convenience method for exporting a Neon function from a module.

pub fn export_value<T: Value>( &mut self, key: &str, val: Handle<'_, T>, ) -> NeonResult<()>

Exports a JavaScript value from a Neon module.

pub fn exports_object(&mut self) -> JsResult<'cx, JsObject>

Produces a handle to a module’s exports object.

Trait Implementations

impl<'cx> Context<'cx> for ModuleContext<'cx>

fn lock<'b>(&'b mut self) -> Lock<'b, Self>

where 'a: 'b,

Lock the JavaScript engine, returning an RAII guard that keeps the lock active as long as the guard is alive.

fn execute_scoped<'b, T, F>(&mut self, f: F) -> T

where F: FnOnce(Cx<'b>) -> T, 'a: 'b,

Executes a computation in a new memory management scope.

fn compute_scoped<'b, V, F>(&mut self, f: F) -> JsResult<'a, V>

where V: Value, F: FnOnce(Cx<'b>) -> JsResult<'b, V>, 'a: 'b,

Executes a computation in a new memory management scope and computes a single result value that outlives the computation.

fn try_catch<T, F>(&mut self, f: F) -> Result<T, Handle<'a, JsValue>>

where F: FnOnce(&mut Self) -> NeonResult<T>,

fn boolean(&mut self, b: bool) -> Handle<'a, JsBoolean>

Convenience method for creating a JsBoolean value.

fn number<T: Into<f64>>(&mut self, x: T) -> Handle<'a, JsNumber>

Convenience method for creating a JsNumber value.

fn string<S: AsRef<str>>(&mut self, s: S) -> Handle<'a, JsString>

Convenience method for creating a JsString value.

fn try_string<S: AsRef<str>>(&mut self, s: S) -> StringResult<'a>

Convenience method for creating a JsString value.

fn null(&mut self) -> Handle<'a, JsNull>

Convenience method for creating a JsNull value.

fn undefined(&mut self) -> Handle<'a, JsUndefined>

Convenience method for creating a JsUndefined value.

fn empty_object(&mut self) -> Handle<'a, JsObject>

Convenience method for creating an empty JsObject value.

fn empty_array(&mut self) -> Handle<'a, JsArray>

Convenience method for creating an empty JsArray value.

fn array_buffer(&mut self, size: usize) -> JsResult<'a, JsArrayBuffer>

Convenience method for creating an empty JsArrayBuffer value.

fn buffer(&mut self, size: usize) -> JsResult<'a, JsBuffer>

Convenience method for creating an empty JsBuffer value.

fn date( &mut self, value: impl Into<f64>, ) -> Result<Handle<'a, JsDate>, DateError>

Available on crate feature napi-5 only.

Convenience method for creating a JsDate value.

fn global<T: Value>(&mut self, name: &str) -> JsResult<'a, T>

Convenience method for looking up a global property by name.

fn global_object(&mut self) -> Handle<'a, JsObject>

Produces a handle to the JavaScript global object.

fn throw<T: Value, U>(&mut self, v: Handle<'_, T>) -> NeonResult<U>

Throws a JS value.

fn error<S: AsRef<str>>(&mut self, msg: S) -> JsResult<'a, JsError>

Creates a direct instance of the Error class.

fn type_error<S: AsRef<str>>(&mut self, msg: S) -> JsResult<'a, JsError>

Creates an instance of the TypeError class.

fn range_error<S: AsRef<str>>(&mut self, msg: S) -> JsResult<'a, JsError>

Creates an instance of the RangeError class.

fn throw_error<S: AsRef<str>, T>(&mut self, msg: S) -> NeonResult<T>

Throws a direct instance of the Error class.

fn throw_type_error<S: AsRef<str>, T>(&mut self, msg: S) -> NeonResult<T>

Throws an instance of the TypeError class.

fn throw_range_error<S: AsRef<str>, T>(&mut self, msg: S) -> NeonResult<T>

Throws an instance of the RangeError class.

fn boxed<U: Finalize + 'static>(&mut self, v: U) -> Handle<'a, JsBox<U>>

Convenience method for wrapping a value in a JsBox.

fn channel(&mut self) -> Channel

Available on crate feature napi-4 only.

Returns an unbounded channel for scheduling events to be executed on the JavaScript thread.

fn promise(&mut self) -> (Deferred, Handle<'a, JsPromise>)

Creates a Deferred and JsPromise pair. The Deferred handle can be used to resolve or reject the JsPromise.

fn task<'cx, O, E>(&'cx mut self, execute: E) -> TaskBuilder<'cx, Self, E>

where O: Send + 'static, E: FnOnce() -> O + Send + 'static, 'a: 'cx,

Creates a TaskBuilder which can be used to schedule the execute callback to asynchronously execute on the Node worker pool.

fn to_raw(&self) -> Env

Available on crate feature sys only.

Gets the raw sys::Env for usage with Node-API.

impl<'cx> Deref for ModuleContext<'cx>

type Target = Cx<'cx>

The resulting type after dereferencing.

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

Dereferences the value.

impl<'cx> DerefMut for ModuleContext<'cx>

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

Mutably dereferences the value.

impl<'cx> From<ModuleContext<'cx>> for Cx<'cx>

fn from(cx: ModuleContext<'cx>) -> Self

Converts to this type from the input type.

impl<'cx> UnwindSafe for ModuleContext<'cx>