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⑥

瀏覽器相容性