此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

FileSystemFileEntry

非标准: 该特性尚未标准化。我们不建议在生产环境中使用非标准特性,因为它们在浏览器中的支持有限,且可能发生变化或被移除。不过,在没有标准选项的特定情况下,它们可以作为合适的替代方案。

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

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

属性

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

方法

file()

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

废弃的方法

createWriter()

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

基本概念

为了向文件写入内容,通过调用 createWriter() 创建 FileWriter 对象。为了读取文件,通过调用 file(),获取表示其内容的 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);

规范

规范
File and Directory Entries API
# api-fileentry

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

浏览器兼容性

参见