ReadableStreamDefaultReader:read() 方法
read() 方法读流里的下一块。
语法
read()参数
无。
返回值
Promise:
- 有数据时得到
{ done: false, value },value是Uint8Array。 - 内容全部读完之后得到
{ done: true, value: undefined }。 - 还没有数据时一直等到有。
- 攒了多少,一次就给多少:读得慢时取走的一块可能比较大。
read() 可以不等上一次完成就再调,结果按调用的先后给。
异常
返回的 Promise 在这些情况下被拒绝:
name 是 'AbortError' 的 Error
请求被 AbortController 取消,或 AbortSignal.timeout() 到时间。正在等待的和之后的 read() 都被拒绝。内容已经全部到达、只是还没读走时也一样。
TypeError
- 下载中途网络中断:
message以Network request failed:开头。中断之前到达、还没读走的内容不再给。 - 调过
releaseLock()之后调用:This reader has been released。 - 等待期间读取器调了
releaseLock()。它要读的那一块不会丢,下一个读取器会读到。
说明
第一次调 read() 之后,读得比下载慢时请求会暂停,见读得慢时请求会暂停。
示例
js
async function main() {
const res = new Response('abc');
if (res.body === null) return;
const reader = res.body.getReader();
const first = await reader.read();
const second = await reader.read();
console.log(first.value, second.done);
}
main();结果:输出一个内容是 97, 98, 99 的 Uint8Array 和 true。
和 Web 的差别
请求被取消时以 AbortError 拒绝。Web 里以 signal.reason 拒绝。