可读流是对底层数据源的封装。底层数据源可以将数据填充到流中,允许消费者通过流的公共接口 读取数据。
1. ReadableStreamDefaultController
来看下面的生成器,它每 1000 毫秒就会生成一个递增的整数:
async function* ints() {
// 每 1000 毫秒生成一个递增的整数 for (let i = 0; i < 5; ++i) {
yield await new Promise((resolve) => setTimeout(resolve, 1000, i)); }
}
这个生成器的值可以通过可读流的控制器传入可读流。访问这个控制器最简单的方式就是创建 ReadableStream 的一个实例,并在这个构造函数的 underlyingSource 参数(第一个参数)中定义 start()方法,然后在这个方法中使用作为参数传入的 controller。默认情况下,这个控制器参数是 ReadableStreamDefaultController 的一个实例:
const readableStream = new ReadableStream({
start(controller) {
console.log(controller); // ReadableStreamDefaultController {} }
});
调用控制器的 enqueue()方法可以把值传入控制器。所有值都传完之后,调用 close()关闭流:
async function* ints() {
// 每 1000 毫秒生成一个递增的整数 for (let i = 0; i < 5; ++i) {
yield await new Promise((resolve) => setTimeout(resolve, 1000, i)); }
}
const readableStream = new ReadableStream({ async start(controller) {
for await (let chunk of ints()) {
controller.enqueue(chunk);
}
controller.close();
} });
ReadableStreamDefaultReader
前面的例子把 5 个值加入了流的队列,但没有把它们从队列中读出来。为此,需要一个 Readable-
StreamDefaultReader 的实例,该实例可以通过流的 getReader()方法获取。调用这个方法会获得 流的锁,保证只有这个读取器可以从流中读取值:
}
yield await new Promise((resolve) => setTimeout(resolve, 1000, i)); }
const readableStream = new ReadableStream({
async start(controller) {
for await (let chunk of ints()) {
controller.enqueue(chunk);
}
controller.close();
}
});
console.log(readableStream.locked); // false
const readableStreamDefaultReader = readableStream.getReader(); console.log(readableStream.locked); // true
消费者使用这个读取器实例的 read()方法可以读出值:
async function* ints() {
// 每 1000 毫秒生成一个递增的整数 for (let i = 0; i < 5; ++i) {
yield await new Promise((resolve) => setTimeout(resolve, 1000, i)); }
}
const readableStream = new ReadableStream({
async start(controller) {
for await (let chunk of ints()) {
controller.enqueue(chunk);
}
controller.close();
}
});
console.log(readableStream.locked); // false
const readableStreamDefaultReader = readableStream.getReader(); console.log(readableStream.locked); // true
// 消费者
(async function() {
while(true) {
const { done, value } = await readableStreamDefaultReader.read();
if (done) {
break;
} else {
console.log(value);
} }
})();
// 0
// 1
// 2
// 3
// 4