FileSystemFileEntry

非标准: 该特性是非标准的，请尽量不要在生产环境中使用它！

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

备注： 由于这是个非标准 API，它的规范当前并不在标准化过程中。重要的是要记住，并不是所有浏览器都实现了它，并且实现它的浏览器可能仅仅实现一小部分。点击 Browser compatibility 来查看更多细节。

属性

从它的父接口 FileSystemEntry (en-US) 继承属性，但是这个接口没有独特的属性。

方法

file() (en-US)

创建新的 File 对象，它可以用于读取文件。

废弃的方法

createWriter() (en-US)

创建新的 FileWriter 对象，它允许写入由文件系统条目表示的对象。

基本概念

为了向文件写入内容，通过调用 createWriter() (en-US) 创建 FileWriter 对象。为了读取文件，通过调用 file() (en-US)，获取表示其内容的 File 对象。

示例

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

js
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);

规范

Specification
File and Directory Entries API
# api-fileentry

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

浏览器兼容性

BCD tables only load in the browser

参见