Skip to content

Write Node.js native addons in Rust with bindings to Node-API.

Notifications You must be signed in to change notification settings

modelfoxdotdev/node_api

Repository files navigation

node_api

This crate provides bindings to the Node-API C API, making it easy to write Node native addons in Rust.

Example

Write your native addon in Rust:

node_api::init!(init);

fn init(env: node_api::Env, exports: node_api::Value) -> Result<node_api:Value, String> {
  let exports = export.as_object();
  let key = node_api::String::new(env, "add")?;
  let value = node_api::Function::new(env, "add", add)?;
  exports.set(key, value);
  Ok(exports.value())
}

#[node_api::function]
fn add(a: u64, b: u64) -> Result<u64, String> {
  Ok(a + b)
}

Then load it in Node.js.

let native = require("./add.node");
assert(native.add(3, 4) === 7);

See the examples folder for a complete example.

Serde integration

To make it easy to move data structures between Rust and Node.js, the node_api crate supports integration with serde.

#[derive(serde::Serialize, serde::Deserialize)]
struct Contact {
  name: String,
  email: String,
}

#[node_api::function]
fn contact(env: node_api::Env) -> node_api::Result<Contact> {
  Ok(Contact {
    name: "John Doe".to_owned(),
    email: "john.doe@example.com".to_owned(),
  })
}
let contact = native.contact();
console.log("Contact name: " + contact.name);
console.log("Contact email: " + contact.email);