@@ -231,15 +231,17 @@ When choosing a SQLite library for Node.js, you have several excellent options.
231231
232232### π·οΈ [ ` node:sqlite ` ] ( https://nodejs.org/docs/latest/api/sqlite.html ) β Node.js Built-in Module
233233
234- * The official SQLite module included with Node.js 22.5.0+ (experimental)*
234+ _ The official SQLite module included with Node.js 22.5.0+ (experimental)_
235235
236236** β¨ Pros:**
237+
237238- ** Zero dependencies** β Built directly into Node.js
238239- ** Official support** β Maintained by the Node.js core team
239240- ** Clean synchronous API** β Simple, predictable blocking operations
240- - ** Full SQLite power** β FTS5, JSON functions, R* Tree, and more
241+ - ** Full SQLite power** β FTS5, JSON functions, R\ * Tree, and more
241242
242243** β οΈ Cons:**
244+
243245- ** Experimental status** β Not yet stable for production use
244246- ** Requires Node.js 22.5.0+** β Won't work on older versions
245247- ** Flag required** β Must use ` --experimental-sqlite ` to enable
@@ -252,14 +254,16 @@ When choosing a SQLite library for Node.js, you have several excellent options.
252254
253255### π [ ` better-sqlite3 ` ] ( https://github.com/WiseLibs/better-sqlite3 ) β The Performance Champion
254256
255- * The most popular high-performance synchronous SQLite library *
257+ _ The most popular high-performance synchronous SQLite library _
256258
257259** β¨ Pros:**
260+
258261- ** Blazing fast** β 2-15x faster than async alternatives
259262- ** Rock-solid stability** β Battle-tested in thousands of production apps
260263- ** Rich feature set** β User functions, aggregates, virtual tables, extensions
261264
262265** β οΈ Cons:**
266+
263267- ** Different API** β Not compatible with Node.js built-in SQLite
264268- ** V8-specific** β Requires separate builds for each Node.js version
265269- ** Synchronous only** β No async operations (usually a feature, not a bug)
@@ -271,9 +275,10 @@ When choosing a SQLite library for Node.js, you have several excellent options.
271275
272276### π¦ [ ` sqlite3 ` ] ( https://github.com/TryGhost/node-sqlite3 ) β The Async Classic
273277
274- * The original asynchronous SQLite binding for Node.js *
278+ _ The original asynchronous SQLite binding for Node.js _
275279
276280** β¨ Pros:**
281+
277282- ** Battle-tested legacy** β 10+ years of production use
278283- ** Massive ecosystem** β 4000+ dependent packages
279284- ** Truly asynchronous** β Non-blocking operations won't freeze your app
@@ -282,6 +287,7 @@ When choosing a SQLite library for Node.js, you have several excellent options.
282287- ** Node-API stable** β One build works across Node.js versions
283288
284289** β οΈ Cons:**
290+
285291- ** Significantly slower** β 2-15x performance penalty vs synchronous libs
286292- ** Callback complexity** β Prone to callback hell without careful design
287293- ** Unnecessary overhead** β SQLite is inherently synchronous anyway
@@ -295,6 +301,7 @@ When choosing a SQLite library for Node.js, you have several excellent options.
295301## π― Quick Decision Guide
296302
297303### Choose ** ` @photostructure/sqlite ` ** when you want:
304+
298305- β
** Future-proof code** that works with both this package AND ` node:sqlite `
299306- β
** Node.js API compatibility** without waiting for stable release
300307- β
** Broad Node.js support** (v20+) without experimental flags
@@ -303,16 +310,19 @@ When choosing a SQLite library for Node.js, you have several excellent options.
303310- β
** Zero migration path** when ` node:sqlite ` becomes stable
304311
305312### Choose ** ` better-sqlite3 ` ** when you want:
313+
306314- β
The most mature and feature-rich synchronous SQLite library
307315- β
Maximum performance above all else
308316- β
A specific API design that differs from Node.js
309317
310318### Choose ** ` sqlite3 ` ** when you have:
319+
311320- β
Legacy code using async/callback patterns
312321- β
Hard requirement for non-blocking operations
313322- β
Need for SQLCipher encryption
314323
315324### Choose ** ` node:sqlite ` ** when you're:
325+
316326- β
Experimenting with bleeding-edge Node.js features
317327- β
Building proof-of-concepts for future migration
318328- β
Working in environments where you control the Node.js version
0 commit comments