node-addon-api
8.9.2 · 12 Aug 2026MIT139.4M / weekRepositorynpmAtom feed
59 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 8.x · latest line
8.9.2
12 Aug 2026Resolve Symbol::For overload ambiguity
8.9.1
31 Jul 2026Fix vs2026 ICE compatibility
8.9.0
26 Jun 2026Add support for SharedArrayBuffer in TypedArray and TypedArrayOf<T>
8.8.0
22 May 2026Add std::string_view overload for Symbol::For
Add String::New overload for string_view
8.7.0
26 Mar 2026Add Date::New overload for a std::chrono::system_clock::time_point
Add support for SharedArrayBuffer in DataViews
8.6.0
27 Feb 2026Add SharedArrayBuffer
Silence a legitimate vfptr sanitizer warning that is on by default in Android NDK 29
8.5.0
14 Jul 2025Add Then and Catch methods to Promise
8.4.0
13 Jun 2025Add sugar method for PropertyLValue
8.3.1
21 Feb 2025Add missing
stdexceptinclude to testnode-api version 10 support
8.3.0
29 Nov 2024Allow catching all exceptions
8.2.2
8 Nov 2024Mark external memory and version APIs as basic
Missing napi_delete_reference on ObjectWrap ref
8.2.1
11 Oct 2024Failed type cast checks in Symbol::WellKnown
Missing node_api_nogc_env definition
8.2.0
30 Sep 2024Add support for nogc types via
BasicEnvAdd support for requiring basic finalizers
Call base basic finalizer if none defined
8.1.0
8 Jul 2024Expose version property in public API
Improve messages on CheckCast
Fix compilation for Visual Studio 2022
Features
Expose version property in public API
Improve messages on CheckCast
Bug Fixes
Fix compilation for Visual Studio 2022
Restore ability to run under NAPI_EXPERIMENTAL
8.0.0
5 Mar 2024- 7.x
7.1.1
12 Jul 20247.1.0
19 Jan 2024src: Add SyntaxError
Add Node.js version restrictions
Handle c++ exception in TSFN callback
What's Changed
src: Add SyntaxError
Add Node.js version restrictions
Handle c++ exception in TSFN callback
src: Remove duplicate buffer info calls
Update LICENSE.md so GitHub recognizes it
gyp: Add common targets
Src,test,build: allow NAPI_VERSION env var and templatize AttachData …
Fixed Broken Links in Docs and Readme
Release v7.1.0
7.0.0
15 Jun 2023- Removed
Drop support for Node.js v14.x and v19.x.
Ensure native receiver exists when calling instance methods and properties.
Fix issue when creating
Napi::Errorinstances that wrap primitives values.
SemVer major release to pull changes since the last release. The main motivations for the release are:
- Removed
Drop support for Node.js v14.x and v19.x.
Ensure native receiver exists when calling instance methods and properties.
Fix issue when creating
Napi::Errorinstances that wrap primitives values.
- 6.x
6.1.0
20 Apr 2023Enforce type checks on
Napi::Value::As().Added
Napi::TypeTaggableclass.Defined
NAPI_HAS_THREADSto make TSFN available on Emscripten.
SemVer minor release to pull changes since the last release. The main motivations for the release are:
Enforce type checks on
Napi::Value::As().Added
Napi::TypeTaggableclass.Defined
NAPI_HAS_THREADSto make TSFN available on Emscripten.Defined
NODE_API_NO_EXTERNAL_BUFFERS_ALLOWEDandNapi::Buffer::NewOrCopy()to handle the support for external buffers.
6.0.0
10 Feb 2023Add
Napi::Object::TypeTag()andNapi::Object::CheckTypeTag()methods.Set operator
napi_callback_infoexplicit.Some minor fixes all over the test suite.
SemVer major release to pull changes since the last release. The main motivations for the release are:
Add
Napi::Object::TypeTag()andNapi::Object::CheckTypeTag()methods.Set operator
napi_callback_infoexplicit.Some minor fixes all over the test suite.
Add tests related to
Napi::Object::TypeTag()andNapi::Object::CheckTypeTag()methods.Add tests related to
Napi::CallbackScope.Add tests related to
Napi::EscapableHandleScope.Add tests related to
Napi::Maybe<T>.Add tests related to
Napi::ThreadSafeFuntion.Change some tests related to Napi::AsyncWorker.
Add documentation for
Napi::Object::TypeTag()andNapi::Object::CheckTypeTag()methods.
- 5.x
5.1.0
13 Jan 2023Fix memory leak in
Napi::AsyncProgressWorkerBase.Add api to get callback_info from
Napi::CallBackInfo.Fix erros and warning in VS 2017.
SemVer minor release to pull changes since the last release. The main motivations for the release are:
Fix memory leak in
Napi::AsyncProgressWorkerBase.Add api to get callback_info from
Napi::CallBackInfo.Fix erros and warning in VS 2017.
Make
Napi::Env::CleanupHookpublic.Remove
Napi::TypedArray::unknown_array_type.Add tests related to
Napi::Env.Add tests related to
Napi::TypedArray.Add tests related to
Napi::AsyncWorker.Add tests related to
Napi::TypedThreadSafeFunction.Add tests related to
Napi::Value.Add test related to
Napi::Promise.Add
Napi::HandleScopeexample.Add Windows with VS 2022 and Node.JS 19.x to the CI matrix.
Fix stale workflow.
Update Node.js versions on CI component.
Add condition for Windows to find eslint.
5.0.0
2 May 2022Drop the support for Node.js v12.x.
Marked methods of wrapper classes
const.Enabled wrapping
Napinamespace with custom namespace.
SemVer major release to pull changes since the last release. The main motivations for the release are:
Drop the support for Node.js v12.x.
Marked methods of wrapper classes
const.Enabled wrapping
Napinamespace with custom namespace.Added an override to
Napi::Function::Callto call it with a c-style array
ofNapi::Value's.Improved the test framework. Added the possibility to run subsets of tests
more easily.Added test for
Napi::AsyncContextclass.Fixed ramdom failure on test for
Napi::ThreadSafeFunctioneNapi::TypedThreadSafeFunctionclass.Fixed compilation problem on debian 8 system.
Added test for
Napi::Object::Set()method.Added some clarifications for
Napi::ClassPropertyDescriptor.Added clarification about weak reference for
Napi::ObjectWrap.Some minor fixes all over the documentation.
Fixed
eslintconfiguration.Fixed CI configuration for Windows.
Enabled pre-commit
ClangFormaton Windows.
- 4.x
4.3.0
21 Jan 2022Added iterator for
Napi::Object.Fixed usage of
napi_extended_error_infoinNapi::Error::New().Added unwrapping logic to handle graceful error handling for primitives.
SemVer minor release to pull changes since the last release. The main motivations for the release are:
Added iterator for
Napi::Object.Fixed usage of
napi_extended_error_infoinNapi::Error::New().Added unwrapping logic to handle graceful error handling for primitives.
Removed travis config.
Updated compiler used for testing.
Added BigInt value test.
Minor fixes all overt est suite.
Documentation of iterator for
Napi::Object.Minor fixes all over documentation.
4.2.0
17 Sep 2021Allow creating Function with move-only functor.
Fixed casts to not be undefined behavior.
Fixed the way to enable C++ exceptions.
SemVer minor release to pull changes since the last release. The main motivations for the release are:
Allow creating Function with move-only functor.
Fixed casts to not be undefined behavior.
Fixed the way to enable C++ exceptions.
Run tests with options to prefix build root path.
Minor fixes all over the documentation.
4.1.0
25 Aug 2021Added the wraps for
napi_add_env_cleanup_hookandnapi_remove_env_cleanup_hook.Added Napi::Maybe<T> class to handle pending exception when cpp exception disabled.
Napi::Referenceupdated the default value to reflect the most possible values when there are any errors occurred onnapi_reference_unref.
SemVer minor release to pull changes since the last release. The main motivations for the release are:
Added the wraps for
napi_add_env_cleanup_hookandnapi_remove_env_cleanup_hook.Added Napi::Maybe<T> class to handle pending exception when cpp exception disabled.
Napi::Referenceupdated the default value to reflect the most possible values when there are any errors occurred onnapi_reference_unref.Added the check for nullpointer on
Napi::Stringinitialization.Added first set of tests for
Napi::Symbol.Updated test suite to avoid parallel running.
Updated example for context sensitivity.
4.0.0
15 Jun 2021Drop the support for Node.js v10.x.
Fix a crashing issue in
Napi::Error::ThrowAsJavaScriptException.
SemVer major release to pull changes since the last release. The main motivations for the release are:
Drop the support for Node.js v10.x.
Fix a crashing issue in
Napi::Error::ThrowAsJavaScriptException.
- 3.x
3.2.1
28 May 2021SemVer patch release to fix the documentation about the oldest Node.js version supported.
3.2.0
17 May 2021SemVer minor release to pull changes since the last release. The main motivations for the release is the addition of a new APIs and a lot of important fixes.
3.1.0
17 Dec 2020SemVer minor release to pull changes since the last release. The main motivations for the release is the addition of a new APIs and a lot of important fixes.
3.0.2
18 Sep 2020Fixed the compilation breakage introduced in the previous release (v3.0.1).
Added the new
Napi::Addonapi to o help handle the loading of a native add-on into multiple
threads and or multiple times in the same thread.Converted tests that gc into async functions that await 10 ticks after each gc.
SemVer patch release to pull changes since the last release. The main motivations for the release are:
Fixed the compilation breakage introduced in the previous release (v3.0.1).
Added the new
Napi::Addonapi to o help handle the loading of a native add-on into multiple
threads and or multiple times in the same thread.Converted tests that gc into async functions that await 10 ticks after each gc.
Refactored test for threasfafe function using async/await.
Some minor corrections all over the test suite and documentation.
3.0.1
13 Jul 2020SemVer patch release to pull changes since the last release. The main motivations for the release are the fix on some api and documentation.
3.0.0
30 Apr 2020SemVer major release to pull changes since the last release. The main motivations for the release are the addition of new APIs and a lot of important fixes.
- 2.x
2.0.2
1 Jul 2020SemVer major release to pull changes since the last release. The main motivation for the release is the backport of some changes in the
Napi::ObjectWrap.2.0.1
2 Jun 2020Security release. The main motivation for the release is the fix for memory corruption vulnerability.
2.0.0
28 Nov 2019Napi::AsyncProgressWorkerNapi::Date
Improvements on the APIs forNapi:: ThreadSafeFunctionandNapi::Object. Furthermore there are some other minor improvements all over the API exposed by the library and its documentation.
SemVer major release to pull changes since the last release. The main motivations for the release are the addition of new APIs:
Napi::AsyncProgressWorkerNapi::Date
Improvements on the APIs forNapi:: ThreadSafeFunctionandNapi::Object. Furthermore there are some other minor improvements all over the API exposed by the library and its documentation.
- 1.x
1.7.2
2 Jun 2020Security release. The main motivation for the release is the fix for memory corruption vulnerability.
1.7.1
23 Jul 2019SemVer patch release to pull changes since the last release. The main motivations for release is to solve compilation problems that happen on Node.js with N-API version less than 4.
1.7.0
23 Jul 2019SemVer patch release to pull changes since the last release. The main motivations for release are the addition of
Napi::ThreadSafeFunctionand new methods forNapi::AsyncWorker. There are some fixes and improvements on all the exposed API and test case. Furthermore there are some other minor fixes on documentation.1.6.3
3 Apr 2019SemVer patch release to pull changes since the last release. The motivations for release are the addition of suppression destruction on
Napi::AsyncWorker, the exposition of macros that throw errors and the fix for potential memory leaks in callback data when error occurs on N-API. Furthermore there are some other minor fixes on documentation.1.6.2
29 Nov 2018SemVer patch release to pull changes since the last release. The motivations for release is to fix the selection of Node.js versions that have N-API.
1.6.1
14 Nov 2018SemVer patch release to pull changes since the last release. The motivations for release is to enable the
Napi::CallbackScopefeature with N-API v3. Furthermore there are some other minor fixes on documentation.1.6.0
2 Nov 2018SemVer minor release to pull changes since the last release. Mostly minor fixes and additions. The motivations for release are the addition of a new feature
Napi::CallbackScope, that helps to have the equivalent of the scope associated with a callback in place when making certain N-API calls. Furthermore there are some additions on tests and improvements on documentation about the ABI stability.1.5.0
3 Oct 2018SemVer minor release to pull changes since the last release. Mostly minor fixes and additions. The motivations for release are the addition of new feature (AsyncContext, BigInt and VersionManagement), some big fixes to avoid memory leaks, the end of the documentation that now cover all the API's surface, the addition of new tool to check if a native add-on is built with N-API or not.
1.4.0
19 Jul 2018SemVer minor release to pull changes since the last release. Mostly minor fixes and additions. The main motivation for release is to improve AsyncWorker and add memory management feature. Furthermore there are numerous additions to the documentation.
1.3.0
8 May 2018SemVer minor release to pull changes since the last release. Mostly minor fixes and additions. The main motivation for release is to add the use of built-in N-API when using the latest version of the 6.x line.
1.2.0
11 Jan 2018SemVer minor release to pull changes since last release. Mostly minor fixes and additions. Main motivation for release it to fix issues in building with earlier releases of 8.X.
1.1.0
20 Nov 2017Pull in all new fixes/features/updates since last release.
1.0.0
27 Sep 2017Sync with Node.js version 8.6.0
- 0.6.x
0.6.3
25 Aug 2017Improve compatibility support for older Node.js versions.
0.6.2
21 Aug 2017Sync with Node.js version 8.4.0
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.