Skip to content

nodejs/node-addon-examples

Folders and files

NameName
Last commit message
Last commit date

Latest commit

bd39695 · Feb 26, 2025
Feb 21, 2025
Feb 7, 2025
Jun 8, 2024
Dec 10, 2020
Nov 3, 2023
Jul 14, 2023
Aug 4, 2023
Aug 4, 2023
Aug 4, 2023
Jan 17, 2025
Jun 21, 2015
Feb 26, 2025
Feb 26, 2025

Repository files navigation

Node.js Addon Examples

A repository of Node.js Addons examples.

Implementations of examples are named either after Node.js versions (node_0.10, node_0.12, etc), or Node.js addon implementation APIs:

  • nan: C++-based abstraction between Node and direct V8 APIs.
  • Node-API: C-based API guaranteeing ABI stability across different node versions as well as JavaScript engines. (Node-API was previously known as N-API.)
  • node-addon-api: header-only C++ wrapper classes which simplify the use of the C-based Node-API.
  • node-addon-api-addon-class: Similar to node-addon-api, but deriving from the Napi::Addon class. 1_hello_world provides an example.

Implementations against unsupported versions of Node.js are provided for completeness and historical context. They are not maintained.

The examples are primarily maintained for Node-API and node-addon-api and as outlined in the Node.js documentation, unless there is a need for direct access to functionality which is not exposed by Node-API, use Node-API.

The Node-API Resource offers an excellent orientation and tips for developers just getting started with Node-API and node-addon-api.

Usage

The directory structure is as follows:

REPO_ROOT
├── test_all.js
├── package.json
├── README.md
└── src
    ├── 1-getting-started
    │   ├── example1
    │   │   ├── nan
    │   │   ├── node-addon-api
    │   │   └── napi
    │   ├── example2
    │   └── example3
    ├── 2-js-to-native-conversion
    ├── 3-context-awareness
    ├── 4-references-and-handle-scope
    ├── 5-async-work
    ├── 6-threadsafe-function
    ├── 7-events
    └── 8-tooling

In each example's implementation subdirectory, run

npm install
node ./

to see the example in action.