This repository is the home for ABI Stable Node API project (NAPI). The goal of this project is to provide a stable Node API for native module developers. NAPI aims to provide ABI compatibility guarantees across different Node versions and also across different Node VMs – allowing NAPI enabled native modules to just work across different versions and flavors of Node.js without recompilations.
This project is in an early proof of concept stage. Check out our roadmap for details on the remaining work.
API Design & Shape
For more details on design of the API, please check out the node-eps covering this effort.
The current shape of the API can be found in header file node_jsvmapi.h
Branches
This repository contains node sources from Node versions 0.10, 0.12, 6.2 and Node-ChakraCore version 7.0, with addition of ABI stable Node APIs. The branches are named according to the node versions that have been enabled with NAPI support.
NAPI enabled modules
Testing
In addition to running the tests in the converted modules. We have also
-
Converted version of the NAN examples that we always keep working abi-stable-node-addon-examples
-
Converted version of the core addons tests which can be run with
make test addons-abi
How to get involved
- Convert a native module to use ABI stable APIs and report issues on conversion and performance;
- Port ABI stable APIs to your fork of Node and let us know if there are gaps;
- Review the roadmap and see how can you can help accelerate this project.
Hangout link for weekly standup https://plus.google.com/u/0/events/c0eevtrlajniu7h8cjrdk0f56c8?authkey=COH04YCalJS8Ug
- aruneshchandra - Arunesh Chandra
- boingoing - Taylor Woll
- digitalinfinity - Hitesh Kanwathirtha
- gabrielschulhof - Gabriel Schulhof
- ianwjhalliday - Ian Halliday
- mhdawson - Michael Dawson
- mykmelez - Myk Melez
- sampsongao - Sampson Gao