# better-sqlite3 changelog

> Fast synchronous SQLite3 bindings for Node.js.

- Vendor: WiseLibs
- Category: Databases & Data
- Official site: https://github.com/WiseLibs/better-sqlite3
- Tracked by: What's New (https://whatsnew.fyi/product/better-sqlite3)
- Harvested from: GitHub (WiseLibs/better-sqlite3)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### v13.0.3

- Date: 2026-08-05
- Version: v13.0.3
- Original notes: https://github.com/WiseLibs/better-sqlite3/releases/tag/v13.0.3
- Permalink: https://whatsnew.fyi/product/better-sqlite3/releases/v13.0.3

- **changed** — Use Ubuntu 22.04-arm for builds

##### What's Changed
* use Ubuntu 22.04-arm by @neoxpert in https://github.com/WiseLibs/better-sqlite3/pull/1510


**Full Changelog**: https://github.com/WiseLibs/better-sqlite3/compare/v13.0.2...v13.0.3

### v13.0.2

- Date: 2026-07-29
- Version: v13.0.2
- Original notes: https://github.com/WiseLibs/better-sqlite3/releases/tag/v13.0.2
- Permalink: https://whatsnew.fyi/product/better-sqlite3/releases/v13.0.2

- **added** — Add gypfile option to package.json
- **changed** — Update SQLite to version 3.53.4
- **fixed** — Validate the parameters of table properly
- **fixed** — Fix process aborting from terminating worker threads

##### What's Changed
* add gypfile option to package.json by @neoxpert in https://github.com/WiseLibs/better-sqlite3/pull/1505
* Update SQLite to version 3.53.4 by @JoshuaWise in https://github.com/WiseLibs/better-sqlite3/pull/1506
* validate the parameters of table properly by @theosotr in https://github.com/WiseLibs/better-sqlite3/pull/1504
* fix: this dependabot configuration does not set a co... in... by @anupamme in https://github.com/WiseLibs/better-sqlite3/pull/1508
* fixed process aborting from terminating worker threads (https://github.com/WiseLibs/better-sqlite3/issues/1507)

##### New Contributors
* @theosotr made their first contribution in https://github.com/WiseLibs/better-sqlite3/pull/1504
* @anupamme made their first contribution in https://github.com/WiseLibs/better-sqlite3/pull/1508

**Full Changelog**: https://github.com/WiseLibs/better-sqlite3/compare/v13.0.1...v13.0.2

### v13.0.1

- Date: 2026-07-21
- Version: v13.0.1
- Original notes: https://github.com/WiseLibs/better-sqlite3/releases/tag/v13.0.1
- Permalink: https://whatsnew.fyi/product/better-sqlite3/releases/v13.0.1

- **fixed** — Fixed a regression in parameter binding where it would be overly strict and reject plain objects from other realms

**Full Changelog**: https://github.com/WiseLibs/better-sqlite3/compare/v13.0.0...v13.0.1

Fixed a regression in parameter binding where it would be overly strict and reject plain objects from other realms (e.g., in jest tests).

### v13.0.0

- Date: 2026-07-21
- Version: v13.0.0
- Original notes: https://github.com/WiseLibs/better-sqlite3/releases/tag/v13.0.0
- Permalink: https://whatsnew.fyi/product/better-sqlite3/releases/v13.0.0

- **changed** — Refactored codebase to use node-addon-api and N-API for compatibility across different versions of Node.js and Electron
- **removed** — Removed deprecated prebuild-install dependency
- **added** — Added db.explain() method for running EXPLAIN queries without needing to supply bound parameters
- **added** — Added preparedStatement.toString() method for getting the expanded SQL of a prepared statement
- **fixed** — Fixed SqliteError cross-realm and Error.isError compatibility

Version `13.0.0` marks a major milestone, as it's the first version of `better-sqlite3` to run on [the N-API](https://nodejs.org/api/n-api.html). This means prebuilt binaries should theoretically work across different versions of Node.js and Electron, and perhaps even other runtimes like Bun. As a result, we've removed the deprecated [`prebuild-install`](https://www.npmjs.com/package/prebuild-install) dependency, and now prebuilt binaries are published directly with the `better-sqlite3` code itself. If your platform/architecture doesn't have a prebuilt binary, it should compile during install as before.

##### What's Changed
* Refactored codebase to use node-addon-api by @JoshuaWise in https://github.com/WiseLibs/better-sqlite3/pull/1498
* Added a new [`db.explain()`](https://github.com/WiseLibs/better-sqlite3/blob/master/docs/api.md#explainstring---array-of-rows) method, for running EXPLAIN queries without needing to supply bound parameters.
* Added a new [`preparedStatement.toString()`](https://github.com/WiseLibs/better-sqlite3/blob/master/docs/api.md#tostring---string) method, for getting the expanded SQL of a prepared statement.
* Fix `SqliteError` cross-realm and `Error.isError` compatibility by @dennismutuku2005 in https://github.com/WiseLibs/better-sqlite3/pull/1473

##### New Contributors
* @dennismutuku2005 made their first contribution in https://github.com/WiseLibs/better-sqlite3/pull/1473

**Full Changelog**: https://github.com/WiseLibs/better-sqlite3/compare/v12.12.0...v13.0.0

### v12.12.0

- Date: 2026-07-15
- Version: v12.12.0
- Original notes: https://github.com/WiseLibs/better-sqlite3/releases/tag/v12.12.0
- Permalink: https://whatsnew.fyi/product/better-sqlite3/releases/v12.12.0

- **changed** — Update SQLite to version 3.53.3
- **changed** — Utilize node:20-trixie for Electron v43 and onwards

##### What's Changed

> [!WARNING]
> ## BREAKING: Starting with Electron v43, binary assets will require glibc 2.41 or higher on Linux hosts.

* Update SQLite to version 3.53.3 by @JoshuaWise in https://github.com/WiseLibs/better-sqlite3/pull/1492
* Utilize node:20-trixie for Electron v43 and onwards by @neoxpert in https://github.com/WiseLibs/better-sqlite3/pull/1495


**Full Changelog**: https://github.com/WiseLibs/better-sqlite3/compare/v12.11.2...v12.12.0

### v12.11.2

- Date: 2026-07-03
- Version: v12.11.2
- Original notes: https://github.com/WiseLibs/better-sqlite3/releases/tag/v12.11.2
- Permalink: https://whatsnew.fyi/product/better-sqlite3/releases/v12.11.2

- **added** — Add support for electron v43 prebuilds

##### What's Changed
* Add support for electron v43 prebuilds by @m4heshd in https://github.com/WiseLibs/better-sqlite3/pull/1490


**Full Changelog**: https://github.com/WiseLibs/better-sqlite3/compare/v12.11.1...v12.11.2

### v12.11.1

- Date: 2026-06-15
- Version: v12.11.1
- Original notes: https://github.com/WiseLibs/better-sqlite3/releases/tag/v12.11.1
- Permalink: https://whatsnew.fyi/product/better-sqlite3/releases/v12.11.1

- **fixed** — Fix Electron v42 build errors on Windows

##### What's Changed
* Fix Electron v42 build errors on Windows by @m4heshd in https://github.com/WiseLibs/better-sqlite3/pull/1488


**Full Changelog**: https://github.com/WiseLibs/better-sqlite3/compare/v12.11.0...v12.11.1

### v12.11.0

- Date: 2026-06-14
- Version: v12.11.0
- Original notes: https://github.com/WiseLibs/better-sqlite3/releases/tag/v12.11.0
- Permalink: https://whatsnew.fyi/product/better-sqlite3/releases/v12.11.0

- **added** — Add missing Electron v42 build target

##### ⚠️CAUTION: NOT A VIABLE RELEASE

Use `v12.11.1` instead.

##### What's Changed
* Add missing Electron v42 build target by @m4heshd in https://github.com/WiseLibs/better-sqlite3/pull/1486


**Full Changelog**: https://github.com/WiseLibs/better-sqlite3/compare/v12.10.1...v12.11.0

### v12.10.1

- Date: 2026-06-13
- Version: v12.10.1
- Original notes: https://github.com/WiseLibs/better-sqlite3/releases/tag/v12.10.1
- Permalink: https://whatsnew.fyi/product/better-sqlite3/releases/v12.10.1

- **fixed** — Fix V8 external API usage for Electron 42

##### What's Changed
* Bump the github-actions group across 1 directory with 4 updates by @dependabot[bot] in https://github.com/WiseLibs/better-sqlite3/pull/1451
* Fix V8 external API usage for Electron 42 by @tstone-1 in https://github.com/WiseLibs/better-sqlite3/pull/1475


**Full Changelog**: https://github.com/WiseLibs/better-sqlite3/compare/v12.10.0...v12.10.1

### v12.10.0

- Date: 2026-05-12
- Version: v12.10.0
- Original notes: https://github.com/WiseLibs/better-sqlite3/releases/tag/v12.10.0
- Permalink: https://whatsnew.fyi/product/better-sqlite3/releases/v12.10.0

- **changed** — Update SQLite to version 3.53.1
- **added** — Add support for Node.js v26 prebuilds
- **removed** — Remove end-of-life builds for Node.js v20 and v23
- **changed** — Temporarily rollback support for Electron v42 prebuilds
- **added** — Enable percentile functions

##### What's Changed
* Update SQLite to version 3.53.1 by @JoshuaWise in https://github.com/WiseLibs/better-sqlite3/pull/1467
* Add support for Node.js v26 prebuilds and remove EOL builds (Node.js v20, v23) by @m4heshd in https://github.com/WiseLibs/better-sqlite3/pull/1468
* Temporarily rollback support for Electron v42 prebuilds by @m4heshd in https://github.com/WiseLibs/better-sqlite3/pull/1470
* Enable percentile functions by @Maxime-J in https://github.com/WiseLibs/better-sqlite3/pull/1447


**Full Changelog**: https://github.com/WiseLibs/better-sqlite3/compare/v12.9.1...v12.10.0