FileSystemFileEntry:createWriter() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

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

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

语法

js
createWriter(successCallback)
createWriter(successCallback, errorCallback)

参数

successCallback

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

errorCallback 可选

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

返回值

无(undefined)。

示例

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

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

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

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

规范

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

浏览器兼容性

另见