可读流是对底层数据源的封装。底层数据源可以将数据填充到流中,允许消费者通过流的公共接口
读取数据。
- 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()方法获取。调用这个方法会获得
流的锁,保证只有这个读取器可以从流中读取值:
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
消费者使用这个读取器实例的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