file system access api通过window.showopenfilepicker()、window.showsavefilepicker()和window.showdirectorypicker()实现浏览器中对本地文件系统的操作。1.调用showopenfilepicker()选择文件并获取句柄，再通过getfile()读取内容；2.showsavefilepicker()配合createwritable()实现文件保存功能；3.showdirectorypicker()用于访问目录及其内容。所有操作必须基于用户授权，并且权限通常为临时性，可在安全上下文中使用该api。兼容性方面需检查api是否存在及是否运行在https环境下，同时完善错误处理机制以应对aborterror、notallowederror等异常。相较于传统文件操作方式，file system Access api支持写入、目录访问及持久化权限等功能，显著提升了web应用的文件管理能力与用户体验。
bom中操作浏览器的文件系统API，核心在于利用现代Web平台提供的File System Access API。这个API让Web应用能够以更接近原生应用的方式，直接与用户的本地文件系统进行交互，比如打开、保存文件，甚至访问目录内容。但所有这些操作都严格建立在用户明确的授权之上，保障了隐私和安全。
解决方案
要操作浏览器的文件系统，我们主要会用到几个全局方法：window.showOpenFilePicker()、window.showSaveFilePicker() 和 window.showDirectoryPicker()。它们返回的都是 FileSystemHandle 对象，具体是 FileSystemFileHandle 或 FileSystemDirectoryHandle。
首先，让我们看看如何打开一个文件：
async function openLocalFile() { try { // 弹出文件选择器，用户可以选择一个或多个文件 // 这里我们只取第一个文件句柄 const [fileHandle] = await window.showOpenFilePicker({ // 允许选择的文件类型，可选 types: [{ description: '文本文件', accept: {'text/plain': ['.txt', '.md']}, }, { description: '图片文件', accept: {'image/*': ['.png', '.gif', '.jpeg', '.jpg']}, }], multiple: false // 只允许选择一个文件 }); // 通过文件句柄获取文件对象 const file = await fileHandle.getFile(); const content = await file.text(); // 或者 file.arrayBuffer() / file.stream() console.log('文件名称:', file.name); console.log('文件内容:', content.substring(0, 200) + '...'); // 打印部分内容 // 你还可以保存这个 fileHandle，以便后续对同一个文件进行写操作， // 只要用户没有撤销权限，或者浏览器会提示重新授权。 return fileHandle; } catch (error) { // 用户取消选择，或者其他错误 if (error.name === 'AbortError') { console.warn('用户取消了文件选择。'); } else { console.error('打开文件时发生错误:', error); } return null; } } // 调用示例： // openLocalFile().then(handle => { // if (handle) { // console.log('文件句柄已获取:', handle); // } // });
接着，是保存文件。这比读取文件稍微复杂一点，因为涉及到创建可写流：
async function saveContentToFile(content, suggestedName = 'untitled.txt') { try { // 弹出保存文件对话框 const fileHandle = await window.showSaveFilePicker({ suggestedName: suggestedName, // 建议的文件名 types: [{ description: '文本文件', accept: {'text/plain': ['.txt']}, }], }); // 创建一个可写流 const writableStream = await fileHandle.createWritable(); // 写入内容 await writableStream.write(content); // 关闭流，完成写入 await writableStream.close(); console.log(`文件 "${fileHandle.name}" 保存成功！`); return fileHandle; } catch (error) { if (error.name === 'AbortError') { console.warn('用户取消了文件保存。'); } else { console.error('保存文件时发生错误:', error); } return null; } } // 调用示例： // saveContentToFile('Hello, File System API!', 'my-awesome-doc.txt');
最后，访问目录内容。这在构建一个简单的Web版文件管理器时非常有用：
async function accessDirectory() { try { const dirHandle = await window.showDirectoryPicker(); console.log('已选择目录:', dirHandle.name); // 遍历目录内容 for await (const entry of dirHandle.values()) { if (entry.kind === 'file') { console.log(` 文件: ${entry.name}`); // 如果需要读取文件内容，可以进一步调用 entry.getFile() // const file = await entry.getFile(); // const content = await file.text(); } else if (entry.kind === 'directory') { console.log(` 目录: ${entry.name}`); // 可以递归地进入子目录 // const subDirHandle = await dirHandle.getDirectoryHandle(entry.name); // await accessDirectoryContent(subDirHandle); } } return dirHandle; } catch (error) { if (error.name === 'AbortError') { console.warn('用户取消了目录选择。'); } else { console.error('访问目录时发生错误:', error); } return null; } } // 调用示例： // accessDirectory();
这些就是 File System Access API 的基本操作。你会发现它确实让Web应用在文件操作方面有了质的飞跃。
浏览器文件系统API的安全性与权限管理
谈到浏览器文件系统API，安全性绝对是绕不开的话题，而且它设计得相当严谨。毕竟，让一个网页直接读写你本地的文件，这听起来就有点让人紧张，对吧？
首先，最核心的一点是：所有文件和目录的访问都必须由用户主动发起。 这意味着，你的Web应用不能在用户不知情的情况下，偷偷摸摸地去访问本地文件。比如，showOpenFilePicker()、showSaveFilePicker() 和 showDirectoryPicker() 这些方法，都必须在响应用户手势（比如点击按钮）时才能被调用。如果你尝试在页面加载时就调用它们，或者在一个非用户触发的事件中调用，浏览器通常会直接拒绝，或者抛出错误。这是为了防止恶意网站通过脚本自动下载或上传文件。
其次，权限是临时的，且粒度很细。 当你通过 showOpenFilePicker() 选择一个文件后，你的Web应用获得了对这个文件句柄的“读取”权限。如果你想写入，还需要用户通过 showSaveFilePicker() 授权。对于目录也是一样，showDirectoryPicker() 授予的是对所选目录及其子内容的读取权限。这种权限通常是“一次性”的，也就是当前会话有效。用户关闭了页面，下次再打开，就需要重新授权。
当然，File System Access API 也提供了持久化权限的能力。通过 fileHandle.requestPermission({ mode: ‘readwrite’ }) 或 directoryHandle.requestPermission({ mode: ‘readwrite’ })，你可以请求用户授予更持久的读写权限。如果用户同意，浏览器可能会记住这个授权，下次访问同一个文件或目录时就无需再次弹窗。但请注意，用户随时可以在浏览器设置中撤销这些权限，Web应用也应该能优雅地处理权限被撤销的情况。
此外，这个API只能在安全上下文（即 https 协议）下使用。这是现代Web API的普遍要求，旨在防止中间人攻击，确保通信的完整性和保密性。在 http:// 协议下，这些API是不可用的，你会发现 window.showOpenFilePicker 根本不存在或者直接报错。
对我个人而言，这种严格的权限模型是必要的，它在赋予Web应用强大能力的同时，也最大程度地保护了用户的隐私和系统安全。开发者需要做的，就是清晰地向用户解释为什么需要这些权限，并确保权限请求的时机和方式都符合预期。
如何处理浏览器文件系统API的兼容性与错误
虽然File System Access API功能强大，但它毕竟是较新的API，所以处理兼容性和各种可能出现的错误就显得尤为重要。这就像你拿到一把新工具，得先知道它在哪能用，以及万一用坏了怎么办。
兼容性检查是第一步。不是所有浏览器都支持这个API，也不是所有版本的浏览器都支持。目前，Chromium 系的浏览器（chrome, edge, Opera）支持得比较好，firefox 和 safari 还在积极开发中或部分支持。在你的代码中，应该始终检查API是否存在：
if ('showOpenFilePicker' in window && window.isSecureContext) { // 浏览器支持 File System Access API 且处于安全上下文 // 可以在这里使用 API } else { // 浏览器不支持或不在安全上下文 console.warn('当前浏览器或环境不支持 File System Access API。请使用 Chrome/Edge 并确保在 HTTPS 环境下。'); // 提供备用方案，比如传统的 <input type="file"> document.getElementById('fallbackFileInput').style.display = 'block'; }
window.isSecureContext 检查当前页面是否运行在安全上下文（HTTPS 或 localhost）中，这是使用许多现代Web API的前提。
错误处理是使用任何异步API的基石，File System Access API 也不例外。由于这些操作涉及到用户交互、文件系统访问等，可能会出现多种错误。最常见的错误是用户取消了操作，这会抛出 AbortError。其他错误可能包括权限不足、文件不存在、磁盘空间不足等。
一个健壮的错误处理通常会使用 try…catch 结构：
async function someFileSystemOperation() { try { // ... 文件系统操作代码 ... } catch (error) { if (error.name === 'AbortError') { console.info('操作被用户取消。'); // 可以给用户一个提示，或者什么都不做 } else if (error.name === 'NotAllowedError') { console.error('权限不足，无法执行此操作。用户可能拒绝了权限或撤销了权限。'); // 提示用户检查浏览器权限设置 } else if (error.name === 'NotFoundError') { console.error('指定的文件或目录未找到。'); } else { console.error('文件系统操作发生未知错误:', error); } // 根据错误类型，可能需要提供备用方案或用户反馈 } }
我个人觉得，对于 AbortError，通常只需要在控制台记录一下，不打扰用户即可。但对于 NotAllowedError 这种明确的权限问题，就应该给用户一个友好的提示，告诉他们可能需要授权。
另外，要注意的是，即使获取了 fileHandle，后续对它的操作（比如 getFile() 或 createWritable()）也可能失败，例如文件被删除、移动，或者权限被撤销。所以，每次使用 fileHandle 时，都应该考虑其操作的原子性和可能产生的错误。
浏览器文件系统API与传统文件操作的异同
在File System Access API出现之前，Web应用处理文件主要依赖于 元素和 FileReader API。现在有了新的API，我们来对比一下它们，看看新工具到底强在哪，又有什么不一样的地方。
相同点：
- 都依赖用户发起： 无论是传统的 还是新的 File System Access API，都必须由用户通过点击、拖拽等手势来触发文件选择或保存操作。这是浏览器安全模型的基础。
- 都处理 Blob 或 File 对象： 最终，你从文件系统中读取到的内容，都会被封装成 File 对象（它继承自 Blob），然后你可以用 FileReader 或 Response.blob() 等方式来处理这些二进制数据。
不同点（也是 File System Access API 的优势所在）：
-
写入能力： 这是最大的区别。传统的 只能读取用户选择的文件，无法直接将数据保存到用户的本地文件系统。如果你想让用户保存文件，你通常需要创建一个 Blob，然后生成一个下载链接 ，让用户点击下载。这体验很糟糕，而且无法覆盖现有文件。 而 File System Access API 则提供了 showSaveFilePicker() 和 createWritable()，允许你直接将数据写入到用户选择的文件路径，甚至可以覆盖现有文件。这让Web应用能够实现真正的“保存”功能，就像桌面应用一样。
-
目录访问： 传统的 虽然可以读取目录，但它返回的是一个文件列表，你无法直接操作这个目录本身，比如创建新文件、删除文件或子目录。 File System Access API 的 showDirectoryPicker() 则直接返回一个 FileSystemDirectoryHandle，你可以用它来遍历目录内容，获取子文件或子目录的句柄，甚至在用户授权下，直接在目录中创建新文件或新子目录（通过 getFileHandle(name, { create: true }) 或 getDirectoryHandle(name, { create: true })）。这对于开发Web版ide、图片管理器等应用至关重要。
-
持久化权限： 传统的 每次操作都需要用户重新选择文件。 File System Access API 允许请求持久化权限。如果用户同意，Web应用可以在后续会话中，无需再次弹窗，直接访问之前授权的文件或目录。这显著提升了用户体验，尤其是在需要频繁操作同一组文件的场景下。
-
流式写入： createWritable() 返回的是一个 WritableStream，这意味着你可以分块写入大文件，而不需要一次性将所有内容加载到内存中。这对于处理大文件非常高效。
总的来说，File System Access API 让Web应用在文件管理方面从“只读”迈向了“读写”，从“一次性”走向了“更持久”，极大地拓展了Web应用的能力边界。它让Web应用在文件操作的体验上，更接近原生桌面应用，也为PWA（Progressive Web Apps）提供了更强大的离线和本地集成能力。当然，伴随能力提升的，是更严格的安全模型和更复杂的API设计，开发者在使用时需要充分理解其机制。
