JavaScript IndexedDB 实战:实现离线草稿保存、自动恢复与数据持久化

在内容管理系统、在线编辑器和业务表单中,用户经常需要输入大量文本。如果页面意外刷新、浏览器关闭或者网络连接中断,尚未提交的数据就可能丢失。

对于简单的字符串配置,可以使用 localStorage 保存数据。但当应用需要存储多个草稿、管理结构化记录或进行异步数据库操作时,IndexedDB 通常是更加合适的选择。

本文使用原生 JavaScript 实现一个浏览器本地草稿管理模块,支持自动保存、页面恢复、手动删除和多草稿管理。

一、IndexedDB 与 localStorage 的区别

localStorage 提供同步的键值存储接口,适合保存少量配置,例如主题模式、界面语言和简单偏好。

IndexedDB 则是浏览器提供的异步数据库,能够保存结构化 JavaScript 数据,并支持索引、事务和游标查询。

两者的主要区别包括:

  • IndexedDB 采用异步操作,不需要在主线程中同步完成数据库读写。
  • 支持对象仓库(Object Store)和索引。
  • 可以保存普通对象、数组及其他支持结构化克隆的数据。
  • 支持事务,便于保证一组数据库操作的一致性。
  • 数据通常在浏览器中持久保存,但仍可能受到用户清理、隐私模式及浏览器存储策略的影响。

对于具有多个编辑页面的应用,IndexedDB 可以作为本地草稿层,但不能直接替代服务端数据库和备份机制。

二、创建文章编辑区域

首先定义一个基础编辑器,提供标题输入框和正文输入框。

html 复制代码
<main class="editor" data-draft-app>
  <h1>文章草稿编辑器</h1>

  <label>
    文章标题
    <input
      type="text"
      data-draft-title
      placeholder="输入文章标题"
    >
  </label>

  <label>
    文章正文
    <textarea
      data-draft-content
      rows="12"
      placeholder="在这里编写正文"
    ></textarea>
  </label>
</main>

<a href="https://www.yxtiktok.com/blog/guides/">

编辑器通过 data-* 属性标识业务组件,避免 JavaScript 逻辑依赖具体的 CSS 类名。

后续所有读写操作都围绕当前草稿的唯一标识进行。

三、初始化 IndexedDB 数据库

IndexedDB 使用 indexedDB.open() 打开数据库。

如果数据库尚不存在,浏览器会自动创建。如果数据库版本升级,则会触发 upgradeneeded 事件。

下面封装数据库初始化函数:

javascript 复制代码
function openDatabase(databaseName, version) {
  return new Promise((resolve, reject) => {
    const request = indexedDB.open(
      databaseName,
      version
    );

    request.onupgradeneeded = () => {
      const db = request.result;

      if (!db.objectStoreNames.contains("drafts")) {
        const store = db.createObjectStore(
          "drafts",
          { keyPath: "id" }
        );

        store.createIndex(
          "updatedAt",
          "updatedAt"
        );
      }
    };

    request.onsuccess = () => {
      resolve(request.result);
    };

    request.onerror = () => {
      reject(request.error);
    };
  });
}

这里创建名为 drafts 的对象仓库,并使用 id 作为记录主键。

同时建立 updatedAt 索引,便于未来根据更新时间查询草稿。

数据库升级逻辑必须集中管理,不能在普通读写事务中随意修改数据库结构。

四、保存文章草稿

草稿保存功能需要收集标题、正文和更新时间,然后写入对象仓库。

页面可以增加一个保存状态区域,便于用户了解当前数据是否已经写入本地数据库。

html 复制代码
<section class="draft-status-panel">
  <h2>保存状态</h2>

  <p
    data-save-status
    role="status"
    aria-live="polite"
  >
    尚未保存
  </p>
</section>

<a href="https://www.yxtiktok.com/blog/guides/">

实现数据库写入:

javascript 复制代码
function saveDraft(db, draft) {
  return new Promise((resolve, reject) => {
    const transaction = db.transaction(
      "drafts",
      "readwrite"
    );

    const store = transaction.objectStore("drafts");

    store.put({
      ...draft,
      updatedAt: Date.now()
    });

    transaction.oncomplete = () => {
      resolve();
    };

    transaction.onerror = () => {
      reject(transaction.error);
    };

    transaction.onabort = () => {
      reject(transaction.error);
    };
  });
}

这里使用 put(),因此已有主键的记录会被更新,不存在的记录则会新增。

需要注意,IndexedDB 请求成功不等于整个事务已经完成。对于保存操作,应该等待事务的 complete 事件,再向用户显示成功状态。

五、使用防抖实现自动保存

如果用户每输入一个字符就执行一次数据库写入,会产生不必要的事务操作。

可以通过防抖,将短时间内连续发生的输入合并成一次保存。

首先添加一个手动保存按钮,作为自动保存以外的备用入口。

html 复制代码
<div class="editor-actions">
  <button
    type="button"
    data-save-draft
  >
    立即保存
  </button>

  <span data-last-saved>
    暂无保存记录
  </span>
</div>

<a href="https://www.yxtiktok.com/blog/guides/">

接下来实现自动保存调度:

javascript 复制代码
function createDebouncedSave(save, delay) {
  let timer = null;

  function schedule() {
    clearTimeout(timer);

    timer = setTimeout(() => {
      timer = null;
      void save();
    }, delay);
  }

  function flush() {
    if (timer !== null) {
      clearTimeout(timer);
      timer = null;
    }

    return save();
  }

  return { schedule, flush };
}

将编辑器输入事件绑定到调度函数即可:

javascript 复制代码
const titleInput = document.querySelector(
  "[data-draft-title]"
);

const contentInput = document.querySelector(
  "[data-draft-content]"
);

const autosave = createDebouncedSave(
  persistCurrentDraft,
  500
);

titleInput.addEventListener(
  "input",
  autosave.schedule
);

contentInput.addEventListener(
  "input",
  autosave.schedule
);

document.querySelector(
  "[data-save-draft]"
).addEventListener("click", () => {
  void autosave.flush();
});

其中,persistCurrentDraft() 由应用负责获取当前草稿 ID、读取输入框数据并调用 saveDraft()。

实际项目中还需要串行化同一草稿的写入,防止多个异步保存操作交叉执行后出现旧内容覆盖新内容的情况。

六、页面刷新后恢复草稿

IndexedDB 的一个重要用途,是在页面重新打开时恢复尚未提交的数据。

可以提供一个恢复按钮,同时支持页面初始化时自动恢复。

html 复制代码
<section class="draft-recovery">
  <h2>恢复本地草稿</h2>

  <p>
    如果编辑内容尚未提交,可以尝试读取浏览器中保存的版本。
  </p>

  <button
    type="button"
    data-restore-draft
  >
    恢复草稿
  </button>
</section>

<a href="https://www.yxtiktok.com/blog/guides/">

数据库查询函数:

javascript 复制代码
function getDraft(db, draftId) {
  return new Promise((resolve, reject) => {
    const transaction = db.transaction(
      "drafts",
      "readonly"
    );

    const request = transaction
      .objectStore("drafts")
      .get(draftId);

    request.onsuccess = () => {
      resolve(request.result ?? null);
    };

    request.onerror = () => {
      reject(request.error);
    };
  });
}

恢复数据时,应该先判断草稿是否存在:

javascript 复制代码
async function restoreDraft(db, draftId) {
  const draft = await getDraft(db, draftId);

  if (!draft) {
    return false;
  }

  titleInput.value = draft.title ?? "";
  contentInput.value = draft.content ?? "";

  return true;
}

草稿恢复不应该无条件覆盖用户已经输入的新内容。

如果页面中已经存在未保存的修改,应该先提示用户确认,或者采用版本比较机制决定保留哪一份内容。

七、删除已经完成的草稿

当文章正式提交到服务端后,本地草稿可能不再需要保留。

此时可以执行删除操作。

html 复制代码
<section class="draft-management">
  <h2>草稿管理</h2>

  <button
    type="button"
    data-delete-draft
  >
    删除本地草稿
  </button>

  <p data-delete-status aria-live="polite"></p>
</section>

<a href="https://www.yxtiktok.com/blog/guides/">

删除函数:

javascript 复制代码
function deleteDraft(db, draftId) {
  return new Promise((resolve, reject) => {
    const transaction = db.transaction(
      "drafts",
      "readwrite"
    );

    transaction
      .objectStore("drafts")
      .delete(draftId);

    transaction.oncomplete = resolve;
    transaction.onerror = () => {
      reject(transaction.error);
    };
    transaction.onabort = () => {
      reject(transaction.error);
    };
  });
}

删除操作应该由明确的用户行为或已确认的业务流程触发。

不要仅仅因为用户关闭页面,就自动删除尚未提交的草稿。

八、IndexedDB 的异常处理

浏览器本地数据库并不是无限容量、永不丢失的存储系统。

实际使用中需要考虑以下场景。

1. 浏览器存储空间不足

IndexedDB 写入可能因为存储配额限制而失败。

前端必须捕获事务异常,向用户显示保存失败的状态。

2. 数据库版本升级冲突

如果一个用户同时打开了多个页面,其中一个页面升级数据库结构,另一个页面可能仍然保持旧数据库连接。

可以使用 versionchange 事件关闭旧连接,配合 blocked 事件向用户提示升级受阻。

3. 多标签页修改同一份草稿

两个标签页同时编辑同一篇文章时,可能产生覆盖问题。

可以为草稿增加版本号,配合 BroadcastChannel 通知其他标签页刷新状态,必要时使用版本冲突检查。

4. 用户主动清理网站数据

IndexedDB 属于浏览器站点数据的一部分。

用户清理浏览器数据、使用隐私模式或切换浏览器配置后,之前保存的草稿可能无法继续访问。

因此,对于重要业务数据,仍然建议提供服务端同步与导出备份机制。

九、总结

IndexedDB 适合处理结构化、异步且需要本地持久化的浏览器数据。

通过对象仓库、事务、防抖保存和草稿恢复机制,可以构建一个可靠性较高的本地编辑体验。

不过,自动保存的关键不只是把数据写入数据库,还包括处理事务完成状态、并发写入、页面恢复和存储异常。

对于在线编辑器、离线表单和复杂后台系统,IndexedDB 可以成为客户端数据保护体系的重要组成部分。