OPFS SyncAccessHandle：高性能二进制读写与锁策略

--- title: "OPFS SyncAccessHandle：高性能二进制读写与锁策略" keywords: - OPFS - SyncAccessHandle - FileSystemFileHandle - 锁与并发 - 二进制读写 description: "介绍 Origin Private File System 的 SyncAccessHandle 接口，进行同步高性能读写与锁管理，适合大型二进制文件与编辑器场景，提供示例与安全建议。" categories: - 文章资讯 - 技术教程 --- 概述 OPFS 提供站点私有的高性能文件系统，`SyncAccessHandle` 允许在 Worker 中进行同步读写并管理锁，适合图像/视频编辑器与数据库缓存等场景。需注意并发与资源释放。 示例（Worker 中） ```js // 主线程获取句柄后传入 Worker // worker.js self.onmessage = async e => { const handle = e.data const sync = await handle.createSyncAccessHandle() const buf = new Uint8Array(1024) sync.write(buf, { at: 0 }) const out = new Uint8Array(1024) sync.read(out, { at: 0 }) sync.flush() sync.close() // 释放锁 } ``` 工程建议 - 并发与锁：避免多个并发写；在关闭前 `flush`；使用 Worker 隔离同步操作。 - 资源管理：及时 `close` 与释放；对错误进行回滚与重试。 - 兼容与回退：不支持 OPFS 的浏览器使用 IndexedDB 或 File System Access；保持数据一致性。 参考与验证 - Chrome 文档（OPFS 与 SyncAccessHandle）：https://developer.chrome.com/docs/web-platform/opfs/ - web.dev OPFS 指南：https://web.dev/articles/origin-private-file-system