@dolthub/doltlite-wasm

中文文档
0.51.11发布于 2026/11/12Apache-2.0ES Module零依赖近 30 天下载 2422

DoltLite被编译为WebAssembly:为浏览器和任何JS运行时间使用多尔特风格的版本控制(branches, confession, community, diff)的 SQLite.

中文使用文档
文档目录5 节
  1. 安装
  2. 浏览器( OPFS 备份, 有持久性)
  3. 节点/ Bun
  4. 入境点
  5. 许可证

@dolthub/多尔特利特-瓦斯姆

点点数 编入WebAssembly: a 滴入 SQLite 有多尔特风格版本控件的构建 - dolt_commit, (中文(简体) ), dolt_branch, (中文(简体) ), dolt_merge, (中文(简体) ), dolt_diff,其余的—— 运行在 浏览器和任何JS运行时间.

这是网络大会的发行。 用于本地节点/ Bun 附加, 使用 @dolthub/doltlite 换句话说.

安装

npm install @dolthub/doltlite-wasm

浏览器( OPFS 备份, 有持久性)

OPFS的持久性要求为页面提供跨原生隔离服务(例如: COOP编号 :COEP 下方是信头;没有信头,你仍然可以得到一个内存数据库.

import { sqlite3InitModule } from '@dolthub/doltlite-wasm';

const sqlite3 = await sqlite3InitModule();

// OpfsDb exists only after the OPFS VFS installs. sqlite3.opfs is removed
// during init, so ('opfs' in sqlite3) stays false even when OPFS is ready.
const db = sqlite3.oo1.OpfsDb
  ? new sqlite3.oo1.OpfsDb('/app.db')
  : new sqlite3.oo1.DB(':memory:');

db.exec(`CREATE TABLE IF NOT EXISTS t(id INTEGER PRIMARY KEY, msg TEXT)`);
db.exec(`INSERT INTO t(msg) VALUES('hello')`);
db.exec(`SELECT dolt_commit('-A', '-m', 'first commit')`);

for (const row of db.selectObjects(`SELECT * FROM dolt_log`)) {
  console.log(row.commit_hash, row.message);
}

OPFS所需的信头( 跨源隔离):

Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corp

节点/ Bun

import { sqlite3InitModule } from '@dolthub/doltlite-wasm';

const sqlite3 = await sqlite3InitModule();
const db = new sqlite3.oo1.DB(':memory:');
db.exec(`CREATE TABLE t(x)`);
db.exec(`SELECT dolt_commit('-A', '-m', 'init')`);

导入加载了节点下所建的节点和捆绑器 浏览器. 路径是进程本地化的 。 对于持久性,序列化或使用本地 @dolthub/doltlite。 。 。 .

入境点

导入使用
@dolthub/doltlite-wasm在节点下建立节点;否则便采用方便捆绑的无害环境管理
@dolthub/doltlite-wasm/sqlite3.mjs普通无害环境管理(无捆绑)
@dolthub/doltlite-wasm/sqlite3-node.mjs节点专用条目
@dolthub/doltlite-wasm/sqlite3-worker1-promiser.mjs工人承诺者 API

JavaScript API是上游的 SQLite WASM API ——参见 sqlite- wam 文档。那里的所有工作; DoltLite 添加 dolt_* 版本控制功能和上方的虚拟表格.

许可证

阿帕奇2.0 (英语). 见 利比里亚. SQLite本身为公有领域.

版本与发布记录

@dolthub/doltlite-wasm 共发布 73 个版本,首次发布于 2026/06/24;过去 12 个月发布了 73 个版本。

版本发布日期距今
0.51.11latest2026/11/121 天前
0.51.102026/11/094 天前
0.51.92026/11/067 天前
0.51.82026/11/058 天前
0.51.72026/11/049 天前
0.51.62026/11/0211 天前

关于 @dolthub/doltlite-wasm 的常见问题

@dolthub/doltlite-wasm 是什么?

DoltLite被编译为WebAssembly:为浏览器和任何JS运行时间使用多尔特风格的版本控制(branches, confession, community, diff)的 SQLite.

如何安装 @dolthub/doltlite-wasm?

在项目目录运行 npm install @dolthub/doltlite-wasm,或使用 pnpm add / yarn add / bun add。

@dolthub/doltlite-wasm 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dolthub__doltlite-wasm 是否存在。

@dolthub/doltlite-wasm 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dolthub/doltlite-wasm 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@dolthub/doltlite-wasm 可以商用吗?

@dolthub/doltlite-wasm 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dolthub/doltlite-wasm 的下载量有多少?

根据 npm 官方下载统计,@dolthub/doltlite-wasm 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,422 次,日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dolthub/doltlite-wasm 还在维护吗?

最新版本 0.51.11 发布于 2026/11/12(1 天前);至今共发布 73 个版本,其中过去 12 个月发布了 73 个;首次发布于 2026/06/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。