可写流是底层数据槽的封装。底层数据槽处理通过流的公共接口写入的数据。
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 返回一个期约,此期约会在能够向流中写入数据时解决。然后,就可以把值传给 writableStream- DefaultWriter.write()方法。写入数据之后,调用 writableStreamDefaultWriter.close() 将流关闭:
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
// 生产者
(async function() {
for await (let chunk of ints()) {
await writableStreamDefaultWriter.ready;
writableStreamDefaultWriter.write(chunk);
}
writableStreamDefaultWriter.close();
})();
转换流
转换流用于组合可读流和可写流。数据块在两个流之间的转换是通过 transform()方法完成的。 20 来看下面的生成器,它每 1000 毫秒就会生成一个递增的整数:
async function* ints() {
// 每 1000 毫秒生成一个递增的整数 for (let i = 0; i < 5; ++i) {
yield await new Promise((resolve) => setTimeout(resolve, 1000, i)); }
}
下面的代码创建了一个 TransformStream 的实例,通过 transform()方法将每个值翻倍:
async function* ints() {
// 每 1000 毫秒生成一个递增的整数 for (let i = 0; i < 5; ++i) {
yield await new Promise((resolve) => setTimeout(resolve, 1000, i)); }
}
const { writable, readable } = new TransformStream({
transform(chunk, controller) {
controller.enqueue(chunk * 2);
}
});
向转换流的组件流(可读流和可写流)传入数据和从中获取数据,与本章前面介绍的方法相同:
async function* ints() {
// 每 1000 毫秒生成一个递增的整数 for (let i = 0; i < 5; ++i) {
yield await new Promise((resolve) => setTimeout(resolve, 1000, i)); }
}
const { writable, readable } = new TransformStream({
transform(chunk, controller) {
controller.enqueue(chunk * 2);
} });
const readableStreamDefaultReader = readable.getReader();
const writableStreamDefaultWriter = writable.getWriter();
// 消费者
(async function() {
while (true) {
const { done, value } = await readableStreamDefaultReader.read();
if (done) {
break;
} else {
console.log(value);
} }
})();
// 生产者
(async function() {
for await (let chunk of ints()) {
await writableStreamDefaultWriter.ready;
writableStreamDefaultWriter.write(chunk);
}
writableStreamDefaultWriter.close();
})();