#nodejs #node #add-on #js #native #api #write

node_api_system

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

7 releases (4 breaking)

0.5.0 Feb 27, 2022
0.4.1 Feb 24, 2022
0.3.1 Jun 24, 2021
0.2.0 Jun 23, 2021
0.1.0 Jun 16, 2021

#1058 in Encoding


Used in node_api

MIT license

26KB
863 lines

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);

No runtime deps

Features