第七部分 — 存储 数据建模与迁移提示

16.1 目的

随着您的扩展程序不断演化,存储的数据也会随之变化。 本节展示了一个轻量级的迁移模式。

16.2 使用场景 / 避免场景

使用场景: 当您需要在版本间安全地更改存储设置而不会破坏现有安装时,请使用此方法。

避免场景: 当您需要一个完整的数据库或复杂的查询(考虑 IndexedDB 或服务器支持的存储)。

16.3 最小化迁移模式

存储一个模式版本:

javascript 复制代码
const KEY = "settings";
const CURRENT = 2;

async function loadSettings() {
  const out = await chrome.storage.local.get({ [KEY]: { version: 0 } });
  let s = out[KEY];

  if (!s || typeof s !== "object") s = { version: 0 };

  // Forward-compat: if a newer version somehow exists, don't smash it.
  if ((s.version ?? 0) > CURRENT) return s;

  while ((s.version ?? 0) < CURRENT) {
    const prev = s.version ?? 0;
    s = migrateOnce(s);
    if ((s.version ?? 0) <= prev) {
      throw new Error("migration did not advance version");
    }
  }

  await chrome.storage.local.set({ [KEY]: s });
  return s;
}

function migrateOnce(s) {
  if (s.version === 0) {
    return { version: 1, enabled: true };
  }
  if (s.version === 1) {
    // example: rename field
    const { enabled } = s;
    return { version: 2, isEnabled: enabled };
  }
  return s;
}

最小示例

一个最小的 MV3 安全异步消息处理程序(适合作为模板使用): CODE_BLOCK_67

16.4 雷区

  • 不具备幂等性的单次迁移

  • 没有版本字段的老安装被破坏

16.5 检查清单

  • 存储 version

  • 使迁移幂等

  • 保持迁移小巧且可测试

16.6 参考资料

相关推荐
codigger1 小时前
ThreadLocal 会内存泄露吗?
java·内存泄漏·threadlocal
挖掘狂人2 小时前
ThreadLocal 会内存泄露吗?
java·安全·架构
未秃头的程序猿2 小时前
给新模块加了个 @MapperScan,启动崩了,最后发现跟 MapperScan 没关系
java·后端·mybatis
SimonKing2 小时前
WorkBuddy又推出新的限免模型(Hy4 flash)了,羊毛可以薅起来了
java·后端·程序员
Rain的Java大神之路2 小时前
别再死背"三级缓存"了!拿 Spring 7.0.8 源码,把 IoC、AOP、事务、循环依赖四大深水区一次蹚平
java·后端·面试
H H.3 小时前
Java企业级开发:从框架到工程化实战
java·开发语言·经验分享·其他·课程设计
wno7043 小时前
springboot整合FastDFS
java·spring boot·后端
顧棟3 小时前
组件生命周期设计:从硬编码初始化到状态机
java·ide
特立独行的猫A11 小时前
别再用 nohup 了:让应用在后台常驻的正确姿势与 systemd 服务详解
java·后端·python
一起_java11 小时前
技术文章-基于Dify-Agent的智能问答系统设计与实现
java·spring boot·后端·agent·dify