This crate extends napi-rs with:
- Local futures runtime
[napi_async]macro for local futuresenv.spawn_local_promise()env.spawn_local()JsPromiseJsRc
Run local futures with:
use napi::*;
use napi_ext::*;
#[napi_async]
async fn my_js_func(env: Env, num: JsNumber) -> napi::Result<JsString> {
task::sleep(Duration::from_millis(1000)).await;
// Log number in JavaScript context
env.console_log(&[num])?;
// Returns Promise<String>
env.create_string("Hello World")
}Allows for the use of async channels, timers and other async utilities in Rust without blocking the main JavaScript thread while retaining the capability of interacting with the underlying JavaScript values.
Install the crate with:
cargo add napi_ext
use std::time::Duration;
use napi::*;
use napi_ext::*;
#[napi_derive::napi]
fn my_js_func(env: Env, callback: JsRc<JsFunction>) -> napi::Result<JsObject> {
env.spawn_local(move |env| async move {
task::sleep(Duration::from_millis(1000)).await;
callback.inner(&env)?.call_without_args(None)?;
Ok(())
})
}import napi from './napi.node'
napi.myJsFunc(() => console.log('Waited for 1 second'))You may combine OS threads with async channels to coordinate off-thread workloads.
I recommend using async_std or async-channel for async utilities as the custom Futures reactor is not compatible with Tokio utilities.
use std::thread;
use std::time::Duration;
use napi::*;
use napi_ext::*;
use async_std::channel;
#[napi_derive::napi]
fn my_js_func(env: Env, callback: JsRc<JsFunction>) -> napi::Result<JsObject> {
let (tx, rx) = channel::unbounded();
thread::spawn(move || {
for i in 0..10 {
tx.send_blocking(i).unwrap();
thread::sleep(Duration::from_millis(1000));
}
});
env.spawn_local(move |env| async move {
while let Ok(value) = rx.recv().await {
println!("Got number: {}", value);
callback.inner(&env)?.call(None, &[env.create_int32(value)?])?;
}
Ok(())
})
}To setup the development environment ensure you have installed just, then run:
npm install
just run example-a
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent