FileSystem:writeBytes() 方法
writeBytes() 方法把 Blob 里的字节写进文件,替换整个文件。
语法
writeBytes(path, blob)参数
path
文件的绝对路径,非空字符串。见路径。
blob
要写入的内容,Blob。手里是 Uint8Array 或 ArrayBuffer 时,先用 new Blob([...]) 包一层。fetch 取回的内容用 response.blob() 读成 Blob,可以直接传进来。
返回值
Promise,兑现成 undefined。Promise 完成时文件已经写好。
文件不存在时创建、已经存在时覆盖、不会自动建目录、写到一半被结束时的情况,和 writeText() 相同。
实测在模拟器上写一个 4 MB 的文件,从调用到 Promise 完成 8.0 ms,这段时间不占用界面所在的线程;new Blob([数据]) 那一步占用 1.2 ms,它把数据复制一份,耗时和数据大小成正比。见文件大小。
异常
TypeError
这时当场抛出,不返回 Promise。
path不是字符串,或是空字符串:writeBytes: path must be a non-empty string。blob不是Blob:writeBytes: the second argument must be a Blob。
示例
js
async function demo() {
const fs = application.fileSystem;
const path = fs.temporary + '/bytes.bin';
await fs.writeBytes(path, new Blob([new Uint8Array([1, 2, 3])]));
const info = await fs.stat(path);
console.log(info.size);
}
demo();结果:输出 3。
对应的 iOS API
-[NSData writeToFile:options:error:],带 NSDataWritingAtomic。NSData 换成 Blob。