前面的例子把 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
Streams API
async function* ints() {
// 每 1000 毫秒生成一个递增的整数 for (let i = 0; i < 5; ++i) {
可写流
可写流是底层数据槽的封装。底层数据槽处理通过流的公共接口写入的数据。
1. 创建 WritableStream
来看下面的生成器,它每 1000 毫秒就会生成一个递增的整数:
async function* ints() {
// 每 1000 毫秒生成一个递增的整数 for (let i = 0; i < 5; ++i) {
yield await new Promise((resolve) => setTimeout(resolve, 1000, i)); }
}
这些值通过可写流的公共接口可以写入流。在传给 WritableStream 构造函数的 underlyingSink 参数中,通过实现
write()方法可以获得写入的数据:
const readableStream = new ReadableStream({
write(value) {
console.log(value);
}
});
2. WritableStreamDefaultWriter
要把获得的数据写入流,可以通过流的 getWriter()方法获取 WritableStreamDefaultWriter的实例。这样会获得流的锁,确保只有一个写入器可以向流中写入数据:
async function* ints() {
// 每 1000 毫秒生成一个递增的整数 for (let i = 0; i < 5; ++i) {
yield await new Promise((resolve) => setTimeout(resolve, 1000, i)); }
}
const writableStream = new WritableStream({
write(value) {
console.log(value);
}
});
console.log(writableStream.locked); // false
const writableStreamDefaultWriter = writableStream.getWriter(); console.log(writableStream.locked); // true
在向流中写入数据前,生产者必须确保写入器可以接收值。writableStreamDefaultWriter.ready 返回一个期约,此期约会在能够向流中写入数据时解决。