FileSystemFileHandle无createSyncAccessHandle方法问题求助

可能的原因及解决方案 #

1. 检查TypeScript的lib配置 #

createSyncAccessHandle属于较新的File System Access API特性，TypeScript默认的DOM类型定义可能未包含该方法。需要在tsconfig.json中确保lib数组包含ESNext和最新DOM相关配置：

{
  "compilerOptions": {
    "lib": ["ESNext", "DOM", "DOM.Iterable"]
  }
}

2. 更新DOM类型依赖 #

如果使用了第三方DOM类型包（比如@types/web或@types/dom-file-system-access），需要更新到最新版本，确保包含该API的类型声明：

npm install @types/web@latest --save-dev
# 或单独针对File System Access API安装类型
npm install @types/dom-file-system-access@latest --save-dev

3. 手动扩展类型声明（临时方案） #

如果上述方法无效，可以在项目中添加类型声明文件（比如file-system.d.ts），手动扩展FileSystemFileHandle接口：

interface FileSystemFileHandle {
  createSyncAccessHandle(): Promise<FileSystemSyncAccessHandle>;
}

确保该文件被TypeScript识别（可在tsconfig.json的include数组中添加对应路径）。

4. 确认运行环境支持 #

虽然这是TypeScript类型错误，但也要注意：createSyncAccessHandle仅在**安全上下文（HTTPS协议或localhost）**中可用，且仅支持Chrome 89+、Edge 89+等较新版本浏览器。

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