大网数据广告活动
Web 标准与前端开发

FileSystemFileEntry

· 52CE 我爱测

文件系统 API 的 **`FileSystemFileEntry`** 接口表示文件系统中的文件。它提供了属性,描述文件的属性,以及 FileSystemFileEntry.file 方法,它创建了可以用于读取文件的 File 对象。

File System API

文件系统 API 的 FileSystemFileEntry 接口表示文件系统中的文件。它提供了属性,描述文件的属性,以及 FileSystemFileEntry.file 方法,它创建了可以用于读取文件的 File 对象。

[!NOTE] 由于这是个非标准 API,它的规范当前并不在标准化过程中。重要的是要记住,并不是所有浏览器都实现了它,并且实现它的浏览器可能仅仅实现一小部分。点击浏览器兼容性来查看更多细节。

属性

从它的父接口 FileSystemEntry 继承属性,但是这个接口没有独特的属性。

方法

  • FileSystemFileEntry.file
    • : 创建新的 File 对象,它可以用于读取文件。

废弃的方法

  • FileSystemFileEntry.createWriter
    • : 创建新的 FileWriter 对象,它允许写入由文件系统条目表示的对象。

基本概念

为了向文件写入内容,通过调用 FileSystemFileEntry.createWriter 创建 FileWriter 对象。为了读取文件,通过调用 FileSystemFileEntry.file,获取表示其内容的 File 对象。

示例

下面的代码创建了一个空文件,叫做 log.txt(如果不存在的话),并使用文本 "Meow" 来填充。在成功的回调中,设置了事件处理器,来处理 error error 和 writeend 事件。通过创建 blob,向其追加文本,以及将 blob 传递给 FileWriter.write(),文本数据写入了文件。

function onInitFs(fs) {
  fs.root.getFile(
    "log.txt",
    { create: true },
    function (fileEntry) {
      // Create a FileWriter object for our FileSystemFileEntry (log.txt).
      fileEntry.createWriter(function (fileWriter) {
        fileWriter.onwriteend = function (e) {
          console.log("Write completed.");
        };

        fileWriter.onerror = function (e) {
          console.log("Write failed: " + e.toString());
        };

        // Create a new Blob and write it to log.txt.
        var bb = new BlobBuilder();
        bb.append("Meow");

        fileWriter.write(bb.getBlob("text/plain"));
      }, errorHandler);
    },
    errorHandler,
  );
}

window.requestFileSystem(window.TEMPORARY, 1024 * 1024, onInitFs, errorHandler);

规范

这个 API 没有官方的 W3C 或者 WHATWG 规范。

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。