JavaScript如何操作文件？FileAPI详解

想要在JavaScript中操作本地文件吗？File System Access API为你打开了新世界的大门！作为现代浏览器提供的新特性，它允许网页在用户授权后安全地读写本地文件和文件夹，为Web应用带来更接近原生应用的体验。本文将深入详解File System Access API的使用方法，包括如何利用 `showOpenFilePicker()` 读取文件，`showSaveFilePicker()` 保存文件，`showDirectoryPicker()` 访问文件夹，以及 `createWritable()` 修改文件内容。同时，我们还将探讨如何请求持久化权限，减少重复授权，提升用户体验。File System Access API适用于文本编辑器、笔记应用等需要本地存储的场景，让你的Web应用拥有更强大的文件处理能力。但请注意，该API目前主要在Chrome和Edge等基于Chromium的浏览器中支持，使用前请务必检查兼容性。

File System Access API 允许网页在用户授权后读写本地文件，支持 Chrome 86+ 和 Edge 95+，通过 showOpenFilePicker() 读取文件，showSaveFilePicker() 保存文件，showDirectoryPicker() 访问文件夹，createWritable() 修改文件内容，并可请求持久化权限以减少重复授权，适用于文本编辑、笔记等需本地存储的场景。

JavaScript 本身在浏览器环境中无法直接访问操作系统文件系统，出于安全考虑，传统 Web API 对文件操作非常受限。但现代浏览器引入了 File System Access API，允许用户主动授权后，网页可以读取、写入和管理本地文件与文件夹。这个 API 提供了更接近原生应用的体验。

启用条件与浏览器支持

File System Access API 目前主要在基于 Chromium 的浏览器中支持（如 Chrome 86+、Edge 95+），Safari 和 Firefox 尚未支持。使用前应检查兼容性：

if ('showOpenFilePicker' in window) {
  // 可以使用 File System Access API
} else {
  alert('你的浏览器不支持此功能，请使用最新版 Chrome 或 Edge');
}

打开并读取文件

通过 showOpenFilePicker() 方法让用户选择文件，获取可操作的句柄，然后读取内容：

async function openFile() {
  try {
    const [fileHandle] = await window.showOpenFilePicker({
      types: [
        {
          description: '文本文件',
          accept: { 'text/plain': ['.txt'] }
        }
      ],
      excludeAcceptAllOption: true,
      multiple: false
    });
<pre class="brush:php;toolbar:false"><code>const file = await fileHandle.getFile();
const contents = await file.text();
console.log(contents);
return contents;</code>

说明：
- types 定义允许选择的文件类型。
- multiple: true 可允许多选。
- 获取到 fileHandle 后，调用 getFile() 得到标准 File 对象，再读取内容。

创建并保存新文件

使用 showSaveFilePicker() 让用户指定保存路径和文件名：

async function saveFile(content) {
  const fileHandle = await window.showSaveFilePicker({
    suggestedName: 'untitled.txt',
    types: [{
      description: '文本文件',
      accept: { 'text/plain': ['.txt'] }
    }]
  });
<p>const writable = await fileHandle.createWritable();
await writable.write(content);
await writable.close();
}</p>

流程：
- 用户选择保存位置。
- 调用 createWritable() 创建可写流。
- 写入内容后关闭流，完成保存。

读写已有文件（修改文件）

如果已有一个文件句柄，可以直接重新写入内容：

async function updateFile(fileHandle, newContent) {
  const writable = await fileHandle.createWritable();
  await writable.write(newContent);
  await writable.close();
}

注意：必须是用户先前通过选择器授予访问权限的文件，不能随意修改任意路径文件。

访问文件夹（目录）

使用 showDirectoryPicker() 可访问整个文件夹结构：

async function openFolder() {
  const dirHandle = await window.showDirectoryPicker();
<p>for await (const entry of dirHandle.values()) {
if (entry.kind === 'file') {
const file = await entry.getFile();
console.log(file.name, file.size);
}
}
}</p>

你可以遍历文件夹中的文件或子目录，并对每个文件进行读取或写入操作。

持久化权限（记住访问过的文件）

一旦用户授予某个文件或文件夹访问权限，可以请求持久保留权限：

if ((await fileHandle.queryPermission({ mode: 'readwrite' })) === 'granted') {
  // 已有权限
} else {
  // 请求权限
  await fileHandle.requestPermission({ mode: 'readwrite' });
}

浏览器可能会记住用户的信任选择，减少重复授权提示。

基本上就这些。File System Access API 让 Web 应用具备了更强的本地文件操作能力，适合编辑器、配置工具、离线笔记等场景。关键是所有操作都需用户主动触发并授权，确保安全。不复杂但容易忽略的是，每次操作都要处理用户取消或异常情况。

到这里，我们也就讲完了《JavaScript如何操作文件？FileAPI详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！