此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

WritableStreamDefaultWriter.desiredSize

基线 广泛可用

自 2022年5月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

WritableStreamDefaultWriter 接口的只读属性 desiredSize 返回填充满流的内部队列需要的大小。

一个整数。请注意,在队列已满的情况下,则可能是负数。

如果无法成功写入流(由于流发生错误或者中止入队),则该值为 null,如果流关闭,则该值为 0。

异常

TypeError

writer 的锁已被释放。

示例

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

...

const writer = writableStream.getWriter();

...

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

规范

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

浏览器兼容性