npm / node-addon-api
node-addon-api
What changed in node-addon-api 2 to 8, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-03.
6 breaking12 new APIs and options10 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initnode-addon-api 813 changes
Breaking changes 1
Support for Node.js v16.x is no longer maintained.
New APIs and options 7
Adds a string_view overload for String::New.
Adds a std::string_view overload for Symbol::For.
Adds an overload accepting a std::chrono::system_clock::time_point.
Adds an API to get an object's prototype.
Adds an API to set an object's prototype.
DataViews now support SharedArrayBuffer.
Adds SharedArrayBuffer support to node-addon-api.
Fixes and other changes 5
Resolves overload ambiguity when using Symbol::For.
Fixed compatibility with VS2026 to address an internal compiler error.
Adds a missing const qualifier to the string parameter.
Fixes an issue involving the -Wextra-semi compiler warning.
Silences a legitimate vfptr sanitizer warning enabled by default in Android NDK 29.
node-addon-api 73 changes
Breaking changes 1
Support for Node.js v14.x and v19.x is dropped.
Fixes and other changes 2
Fixes creating Napi::Error instances that wrap primitive values.
A native receiver is ensured when calling instance methods and properties.
node-addon-api 63 changes
Breaking changes 1
The conversion operator for napi_callback_info is explicit.
New APIs and options 2
Adds a method for checking a Napi::Object's type tag.
Adds a method for tagging a Napi::Object with a type tag.
node-addon-api 55 changes
Breaking changes 2
Methods of wrapper classes were marked
const, affecting how they can be called on const wrapper objects.Support for Node.js v12.x was dropped, so projects using this release need a newer Node.js version.
New APIs and options 2
An overload was added to call the function with a C-style array of Napi::Value values.
The namespace can now be wrapped with a custom namespace.
Fixes and other changes 1
A compilation problem on Debian 8 was fixed.
node-addon-api 42 changes
Breaking changes 1
Support for Node.js v10.x was dropped.
Fixes and other changes 1
Fixes a crashing issue in this API.
node-addon-api 22 changes
New APIs and options 1
A new API is available for asynchronous progress workers.
Fixes and other changes 1
The API has been improved; the notes do not specify the details.