WritableStreamDefaultWriter: desiredSize 属性

Baseline 已广泛支持

此功能已成熟,并可在许多设备和浏览器版本上使用。自 2022 年 5 月以来,它已在各个浏览器中可用。

注意:此功能在 Web Workers 中可用。

desiredSizeWritableStreamDefaultWriter 接口的一个只读属性,它返回填满流内部队列所需的期望大小。

一个整数。请注意,如果队列已满,该值可以为负数。

如果流无法成功写入(因为它已出错,或有中止排队),则该值为 null;如果流已关闭,则该值为零。

异常

TypeError

writer 的锁被释放。

示例

js
const writableStream = new WritableStream(
  {
    write(chunk) {
      // …
    },
    close() {
      // …
    },
    abort(err) {
      // …
    },
  },
  queuingStrategy,
);

// …

const writer = writableStream.getWriter();

// …

// return stream's desired size
const size = writer.desiredSize;

规范

规范
Streams
# ref-for-default-writer-desired-size⑥

浏览器兼容性