可写流是底层数据槽的封装。底层数据槽处理通过流的公共接口写入的数据。

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();
    })();