# What changed in node-addon-api

> 28 changes in node-addon-api 2 to 8 from its official release notes, upgrade guides and advisories: 6 breaking, 12 new APIs and options. Each one cited. Sources checked 2026-11-03. HTML: https://unstale.sh/npm/node-addon-api/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## node-addon-api 8

### Breaking changes

- Support for Node.js v16.x is no longer maintained. (8.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.0.0)

### New APIs and options

- Adds a string_view overload for String::New. (8.8.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.8.0)
- Adds a std::string_view overload for Symbol::For. (8.8.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.8.0)
- Adds an overload accepting a std::chrono::system_clock::time_point. (8.7.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.7.0)
- Adds an API to get an object's prototype. (8.7.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.7.0)
- Adds an API to set an object's prototype. (8.7.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.7.0)
- DataViews now support SharedArrayBuffer. (8.7.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.7.0)
- Adds SharedArrayBuffer support to node-addon-api. (8.6.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.6.0)

### Fixes and other changes

- Resolves overload ambiguity when using Symbol::For. (8.9.2) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.9.2)
- Fixed compatibility with VS2026 to address an internal compiler error. (8.9.1) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.9.1)
- Adds a missing const qualifier to the string parameter. (8.7.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.7.0)
- Fixes an issue involving the -Wextra-semi compiler warning. (8.7.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.7.0)
- Silences a legitimate vfptr sanitizer warning enabled by default in Android NDK 29. (8.6.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v8.6.0)

## node-addon-api 7

### Breaking changes

- Support for Node.js v14.x and v19.x is dropped. (7.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v7.0.0)

### Fixes and other changes

- Fixes creating Napi::Error instances that wrap primitive values. (7.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v7.0.0)
- A native receiver is ensured when calling instance methods and properties. (7.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v7.0.0)

## node-addon-api 6

### Breaking changes

- The conversion operator for napi_callback_info is explicit. (6.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v6.0.0)

### New APIs and options

- Adds a method for checking a Napi::Object's type tag. (6.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v6.0.0)
- Adds a method for tagging a Napi::Object with a type tag. (6.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v6.0.0)

## node-addon-api 5

### Breaking changes

- Methods of wrapper classes were marked `const`, affecting how they can be called on const wrapper objects. (5.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v5.0.0)
- Support for Node.js v12.x was dropped, so projects using this release need a newer Node.js version. (5.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v5.0.0)

### New APIs and options

- An overload was added to call the function with a C-style array of Napi::Value values. (5.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v5.0.0)
- The namespace can now be wrapped with a custom namespace. (5.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v5.0.0)

### Fixes and other changes

- A compilation problem on Debian 8 was fixed. (5.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/v5.0.0)

## node-addon-api 4

### Breaking changes

- Support for Node.js v10.x was dropped. (4.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/4.0.0)

### Fixes and other changes

- Fixes a crashing issue in this API. (4.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/4.0.0)

## node-addon-api 2

### New APIs and options

- A new API is available for asynchronous progress workers. (2.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/2.0.0)

### Fixes and other changes

- The API has been improved; the notes do not specify the details. (2.0.0) — [release notes](https://github.com/nodejs/node-addon-api/releases/tag/2.0.0)