File System Access API允许Web应用在安全上下文中直接读写本地文件。通过showOpenFilePicker()选择文件并获取FileSystemFileHandle,调用getFile()后使用text()、arrayBuffer()或stream()读取内容,支持文本、二进制和大文件。保存文件需用showSaveFilePicker()获取句柄,创建可写流并写入数据。该API仅在HTTPS或localhost下由用户触发时可用,且主要支持Chrome 86+,Safari等浏览器暂不支持,需降级处理。核心是“句柄”机制,确保安全访问。

JavaScript的File System Access API让Web应用可以直接与用户设备上的文件系统交互,允许读取、写入和保存本地文件,而无需通过传统的上传下载方式。这个API主要在现代浏览器(如Chrome 86+)中支持,适用于需要处理本地文档的应用,比如文本编辑器、代码编辑工具等。
请求访问单个文件
使用showOpenFilePicker()方法可以让用户选择一个或多个文件,并获取对它们的访问权限。
基本用法如下:
async function openFile() { try { const [fileHandle] = await window.showOpenFile_picker(); const file = await fileHandle.getFile(); const content = await file.text(); console.log(content); } catch (err) { console.error("用户取消操作或发生错误", err); }}
说明:
立即学习“Java免费学习笔记(深入)”;
调用showOpenFilePicker()会弹出文件选择框 返回的是FileSystemFileHandle对象数组,从中可获取实际文件 getFile() 获取File对象,再用.text()读取文本内容
读取多种类型文件内容
根据文件类型,可以使用不同方法读取内容:
文本文件(.txt, .json, .js 等):使用file.text() 二进制数据(图片、PDF等):使用file.arrayBuffer() 大文件流式读取:使用file.stream()
示例:读取JSON文件
async function openJSONFile() { const [handle] = await window.showOpenFilePicker({ types: [{ description: 'JSON 文件', accept: { 'application/json': ['.json'] } }] }); const file = await handle.getFile(); const content = await file.text(); return JSON.parse(content);}
将内容保存到文件
使用showSaveFilePicker()可以让用户指定保存路径并写入文件。
步骤包括:
请求保存位置,获得文件句柄 创建可写流 写入内容并关闭流
示例:保存文本内容
async function saveFile(content) { const handle = await window.showSaveFilePicker({ suggestedName: 'document.txt', types: [{ description: '文本文档', accept: { 'text/plain': ['.txt'] } }] }); const writable = await handle.createWritable(); await writable.write(content); await writable.close();}
检查浏览器支持和安全限制
该API只能在安全上下文中使用(HTTPS 或 localhost),并且需要用户主动触发(如点击按钮)才能调用。
建议先检测是否支持:
if ('showOpenFilePicker' in window) { // 可以使用 File System Access API} else { alert('当前浏览器不支持此功能,请使用 Chrome 或 Edge 最新版');}
注意:Safari 和部分浏览器暂未支持,需做好降级处理(例如回退到 input[type=file])。
基本上就这些。掌握这几个核心方法后,就能实现较完整的本地文件读写功能。关键是理解“句柄(Handle)”的概念——它代表对某个文件或目录的引用,是安全模型的一部分,避免网页随意访问整个磁盘。
以上就是如何利用JavaScript的File System Access API访问本地文件?的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1529273.html
微信扫一扫
支付宝扫一扫