Response:blob() 方法
blob() 方法读出全部响应内容,得到一个 Blob。内容不进入 JS 的内存。
语法
blob()参数
无。
返回值
Promise。内容全部下载完之后完成,得到 Blob。
Blob的type是空串,不取响应头里的Content-Type。- 没有内容的响应得到
size为 0 的Blob。
异常
返回的 Promise 在这些情况下被拒绝:
TypeError
- 内容已经读过:
Body has already been read。 body上有读取器:Body is locked: response.body has a reader。- 下载中途网络中断:
message以Network request failed:开头。
name 是 'AbortError' 的 Error
下载中途请求被取消,或者 AbortSignal.timeout() 到了时间。
说明
文件和图片用它读。拿到的 Blob 直接交给 UIImage.imageWithData() 或 application.fileSystem 的 writeBytes()。内容从下载到交出去都不进入 JS 的内存;下载期间整个内容仍然在 App 的内存里。
示例
js
async function main() {
const res = await fetch('https://httpbin.org/image/png');
const blob = await res.blob();
const image = UIImage.imageWithData(blob);
console.log(blob.size, image !== null);
}
main();结果:输出图片的字节数和 true。内容不是图片时 image 是 null。
和 Web 的差别
Web 里得到的 Blob 的 type 取自 Content-Type。Nacre 里是空串。