BOM中如何操作浏览器的文件系统API？-js教程-PHP中文网

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？

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应用强大能力的同时，也最大程度地保护了用户的隐私和系统安全。开发者需要做的，就是清晰地向用户解释为什么需要这些权限，并确保权限请求的时机和方式都符合预期。

易森网络企业版

如果您是新用户，请直接将本程序的所有文件上传在任一文件夹下，Rewrite 目录下放置了伪静态规则和筛选器，可将规则添加进IIS，即可正常使用，不用进行任何设置；(可修改图片等)默认的管理员用户名、密码和验证码都是：yeesen系统默认关闭，请上传后登陆后台点击“核心管理”里操作如下:进入“配置管理”中的&ld

查看详情

如何处理浏览器文件系统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应用处理文件主要依赖于 <input type="file"> 元素和 FileReader API。现在有了新的API，我们来对比一下它们，看看新工具到底强在哪，又有什么不一样的地方。

相同点：

都依赖用户发起： 无论是传统的 <input type="file"> 还是新的 File System Access API，都必须由用户通过点击、拖拽等手势来触发文件选择或保存操作。这是浏览器安全模型的基础。
都处理 Blob 或 File 对象： 最终，你从文件系统中读取到的内容，都会被封装成 File 对象（它继承自 Blob），然后你可以用 FileReader 或 Response.blob() 等方式来处理这些二进制数据。

不同点（也是 File System Access API 的优势所在）：

写入能力： 这是最大的区别。传统的 <input type="file"> 只能读取用户选择的文件，无法直接将数据保存到用户的本地文件系统。如果你想让用户保存文件，你通常需要创建一个 Blob，然后生成一个下载链接 <a href="..." download>，让用户点击下载。这体验很糟糕，而且无法覆盖现有文件。而 File System Access API 则提供了 showSaveFilePicker() 和 createWritable()，允许你直接将数据写入到用户选择的文件路径，甚至可以覆盖现有文件。这让Web应用能够实现真正的“保存”功能，就像桌面应用一样。
目录访问： 传统的 <input type="file" webkitdirectory> 虽然可以读取目录，但它返回的是一个文件列表，你无法直接操作这个目录本身，比如创建新文件、删除文件或子目录。 File System Access API 的 showDirectoryPicker() 则直接返回一个 FileSystemDirectoryHandle，你可以用它来遍历目录内容，获取子文件或子目录的句柄，甚至在用户授权下，直接在目录中创建新文件或新子目录（通过 getFileHandle(name, { create: true }) 或 getDirectoryHandle(name, { create: true })）。这对于开发Web版IDE、图片管理器等应用至关重要。
持久化权限： 传统的 <input type="file"> 每次操作都需要用户重新选择文件。 File System Access API 允许请求持久化权限。如果用户同意，Web应用可以在后续会话中，无需再次弹窗，直接访问之前授权的文件或目录。这显著提升了用户体验，尤其是在需要频繁操作同一组文件的场景下。
流式写入： createWritable() 返回的是一个 WritableStream，这意味着你可以分块写入大文件，而不需要一次性将所有内容加载到内存中。这对于处理大文件非常高效。

总的来说，File System Access API 让Web应用在文件管理方面从“只读”迈向了“读写”，从“一次性”走向了“更持久”，极大地拓展了Web应用的能力边界。它让Web应用在文件操作的体验上，更接近原生桌面应用，也为PWA（Progressive Web Apps）提供了更强大的离线和本地集成能力。当然，伴随能力提升的，是更严格的安全模型和更复杂的API设计，开发者在使用时需要充分理解其机制。

以上就是BOM中如何操作浏览器的文件系统API？的详细内容，更多请关注php中文网其它相关文章！