ReadableStreamDefaultController: error() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

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

ReadableStreamDefaultController 介面的 error() 方法會使與該流相關的任何未來互動都發生錯誤。

注意:error() 方法可以被呼叫多次,也可以在流不可讀時呼叫。

語法

js
error(e)

引數

e

你希望未來互動失敗的錯誤。

返回值

無(undefined)。

異常

TypeError

如果源物件不是 ReadableStreamDefaultController,則丟擲此錯誤。

示例

規範中的 具有底層推送源和反壓支援的可讀流 示例很好地展示瞭如何使用 ReadableStreamDefaultController.desiredSize 手動檢測流何時已滿並應用反壓,以及如何使用 error() 手動觸發流錯誤(如果其依賴的其他系統部分失敗)。

規範

規範
Streams
# rs-default-controller-error

瀏覽器相容性

另見