Angular依赖升级后PouchDB调用出现TypeScript类型错误

问题根源 #

Angular 15.2升级后，附带的TypeScript类型检查严格度提升（或TypeScript版本小幅更新），而PouchDB的allDocs返回的行类型是联合类型：要么包含doc属性（查询成功时），要么包含error属性（查询失败时）。之前的TypeScript版本未强制要求对这种联合类型做属性访问前的类型判断，现在则会触发类型错误。

解决方案 #

1. 用类型守卫做安全访问（推荐）

显式判断当前行是否不存在error属性，再访问doc：

const dbResult = await yourPouchDbInstance.allDocs({ include_docs: true });
const targetRow = dbResult.rows[0];

// 类型守卫：排除带error的情况
if (!('error' in targetRow)) {
  const docId = targetRow.doc._id;
  // 后续操作
} else {
  // 处理查询失败的情况，比如打印error信息
  console.error(`查询失败: ${targetRow.error}`);
}

2. 升级PouchDB类型定义包

如果你的@pouchdb/types版本较旧，可能存在类型定义兼容性问题，执行升级命令：

npm update @pouchdb/types

3. 临时降低类型检查严格度（不推荐长期使用）

如果不想修改代码，可在tsconfig.json中调整TypeScript配置，放宽联合类型检查：

{
  "compilerOptions": {
    "strictNullChecks": false,
    "strictPropertyInitialization": false
  }
}

补充说明 #

这种类型错误本质是TypeScript对联合类型的安全检查强化，虽然增加了代码的繁琐度，但能避免潜在的运行时错误（比如访问不存在的doc导致的undefined报错）。优先推荐使用类型守卫的方式处理，保证代码的健壮性。

内容的提问来源于stack exchange，提问作者TomStroemer