file system access api 允许网页在用户授权下直接读写本地文件,需通过 showopenfilepicker、showsavefilepicker 或 showdirectorypicker 获取句柄,支持文本/二进制读写及目录遍历,仅 chromium 支持且权限基于用户显式选择。

File System Access API 允许网页在用户明确授权下,直接读写本地文件系统中的文件和文件夹,不再依赖 input[type="file"] 或 Blob URL 等间接方式。它不是 Node.js 的 fs 模块,也不绕过浏览器安全沙箱——所有操作都需用户主动选择文件或目录,且权限仅限于所选范围。
获取文件句柄并读取内容
先通过 showOpenFilePicker() 让用户选择文件,返回一个 FileSystemFileHandle,再调用其 getFile() 获取 File 对象,即可用标准 FileReader 或 TextEncoder/TextDecoder 读取:
- 支持单文件或多文件选择(传入
{ multiple: true }) - 读取文本推荐用
file.text()(返回 Promise),比 FileReader 更简洁 - 读取二进制数据可用
file.arrayBuffer(),适合图片、音频等处理
写入文件:保存新文件或覆盖现有文件
写入分两步:先用 showSaveFilePicker() 获取目标文件句柄,再用 createWritable() 创建可写流:
下载 Comet AI 浏览器,体验由 Perplexity AI 驱动的革命性上网方式。内置 AI 助手可实时总结网页、跨标签页对比信息、自动执行任务。告别繁琐操作,让 AI 成为你的浏览副驾,大幅提升研究与工作效率。支持 Windows、macOS、Android 和 iOS。
- 调用
showSaveFilePicker()时可预设文件名、类型(suggestedName,types)提升体验 -
writable.write()支持字符串、ArrayBuffer、Blob、TypedArray 等多种数据类型 - 务必调用
writable.close()完成写入,否则内容可能不完整
访问整个文件夹(需用户授权)
用 showDirectoryPicker() 获取 FileSystemDirectoryHandle,之后可遍历、创建、删除其中的文件或子目录:
- 遍历用
dirHandle.keys()或for await (const entry of dirHandle.values()) - 创建新文件:
dirHandle.getFileHandle("log.txt", { create: true }) - 注意:删除文件/目录需额外调用
removeEntry(),且不能跨目录操作
权限与兼容性注意事项
该 API 目前仅 Chromium 内核浏览器(Chrome 86+、Edge 86+、Opera 72+)支持,Firefox 和 Safari 尚未实现。权限是基于“手动生成”的——每次访问都需用户点击确认,但可通过 handle.queryPermission({ mode: "readwrite" }) 和 handle.requestPermission() 检查或复用已有授权(仅对已打开过的句柄有效):
- 句柄可序列化存储(如 IndexedDB),下次访问时用
navigator.storage.getDirectory()+resolve()恢复路径 - 敏感操作(如写入系统目录)会被浏览器拦截,只能访问用户主动选择的位置
- 不要假设句柄永久有效——用户可能移除权限或重装系统,使用前建议
handle.isSameEntry(anotherHandle)或捕获异常
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










