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 的浏览器中加载。