FileSystemFileEntry:createWriter() 方法

已弃用: 不再推荐使用此功能。尽管某些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中移除,可能正在被删除,或者可能仅出于兼容性目的而保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的兼容性表 以指导您的决策。请注意,此功能可能随时停止工作。

非标准: 此功能是非标准的,并且不在标准轨道上。不要在面向 Web 的生产站点上使用它:它不会对每个用户都起作用。实现之间也可能存在很大的不兼容性,并且行为将来可能会发生变化。

FileSystemFileEntry 接口的createWriter()方法返回一个FileWriter对象,该对象可用于将数据写入目录条目所表示的文件。

语法

js
createWriter(successCallback)
createWriter(successCallback, errorCallback)

参数

successCallback

成功创建FileWriter时调用的回调函数;FileWriter作为唯一参数传递到回调函数中。

errorCallback 可选

如果提供,则此方法必须在尝试创建FileWriter时发生错误时调用。此回调函数将FileError对象作为输入接收,该对象描述了错误。

返回值

无(undefined)。

示例

此示例建立了一个方法writeToFileEntry(),该方法将文本字符串输出到与传入的目录条目对应的文件。

js
function writeToFileEntry(entry, text) {
  entry.createWriter(
    (fileWriter) => {
      let data = Blob([text], { type: "text/plain" });

      fileWriter.write(data);
    },
    (fileError) => {
      /* do whatever to handle the error */
    },
  );
}

createWriter()调用的成功回调函数将传入的文本获取并创建一个新的Blob对象(类型为text/plain),其中包含传入的文本。然后,此 Blob 将输出到FileWriter对象以写入文件。

规范

此功能不再属于任何规范的一部分。它不再有望成为标准。

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅