nodejs 0.3.0

Embedding Node.js in Rust
Documentation

rust-nodejs

Test Clippy Check

Embedding Node.js in Rust.

  • Queue tasks to the Node.js event loop thread-safely.
  • Interact with the Node.js runtime via Neon API.
  • Link with prebuilt Node.js binaries to save compile time.
  • Native modules are supported.

Guide

  1. let channel = nodejs::channel() to get the global Node.js channel.
  2. Call channel.send to run tasks in the Node.js event queue.
  3. Inside the task, use nodejs::neon for interoperability between Node.js and Rust. Neon documentation

Example

let (tx, rx) = std::sync::mpsc::sync_channel::<String>(0);
let channel = nodejs::channel();
channel.send(move |mut cx| {
    use nodejs::neon::{context::Context, reflect::eval, types::JsString};
    let script = cx.string("require('http').STATUS_CODES[418]");
    let whoami = eval(&mut cx, script)?;
    let whoami = whoami.downcast_or_throw::<JsString, _>(&mut cx)?;
    tx.send(whoami.value(&mut cx)).unwrap();
    Ok(())
});
let whoami = rx.recv().unwrap();
assert_eq!(whoami, "I'm a Teapot");