HTML5 文件系统 API 运行在浏览器沙箱中，仅提供对独立虚拟文件系统的读写权限，不访问真实本地路径；所有操作限于页面专属逻辑卷，依赖配额管理而非用户授权，安全但用途有限。

HTML5 文件系统 API 不提供对用户本地文件系统的直接访问。它运行在浏览器强制隔离的沙箱环境中，所有读写操作都限定在独立、私有的虚拟文件系统内，与真实磁盘路径完全无关。

沙箱环境的本质是隔离，不是授权

所谓“文件系统”，其实是浏览器为每个源（origin）单独分配的一块内存或临时存储空间。你调用 requestFileSystem 得到的，是一个仅对该页面可见的逻辑卷，目录结构由 JS 控制，底层不映射任何真实路径。这意味着：

• 无法通过该 API 打开、读取或修改用户桌面上的 .txt 或 .pdf 文件
• 不同网站（哪怕同域名不同端口）之间的文件系统完全不互通
• 关闭标签页或清除浏览数据后，这些“文件”通常自动销毁（除非显式使用持久化配额）

权限机制靠配额管理，而非用户弹窗授权

浏览器不向用户索取“允许访问文件”的明确许可，而是通过配额（Quota）间接控制写入能力：

DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

下载

• 初始配额很小（如 Chrome 约 10MB），超出则 FS.write() 失败并抛出 QUOTA_EXCEEDED_ERR
• 可调用 navigator.storage.persist() 请求持久化，但是否批准由浏览器策略决定（例如仅对安装为 PWA 的站点开放）
• 没有“读取任意文件”权限——所有读操作必须基于此前自己创建或接收的 FileEntry / DirectoryEntry 对象

与 的关键区别

很多人混淆 HTML5 文件系统 API 和文件选择器。二者完全不同：

• ：用户主动选取文件 → 页面获得只读的 File 对象 → 可读内容，但不能写回原位置
• 文件系统 API：JS 自主创建/组织虚拟目录 → 全读写，但仅限沙箱内部 → 与用户文件无任何路径关联
• 前者是用户授权的数据导入通道，后者是应用自管的临时缓存空间

为什么说它“安全但有限”

安全体现在设计初衷上：它从不碰真实文件系统，不触发系统级权限请求，也不暴露路径信息；有限则反映在实际用途中：

• 适合离线缓存资源、暂存编辑草稿、构建本地文件管理 UI（如模拟桌面）
• 不适合替代下载、上传、配置同步等需跨设备或跨会话持久化的场景
• 现代开发中，Cache API + IndexedDB + File System Access API（新标准，需用户手势）已逐步覆盖其功能边界

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！