WritableStreamDefaultController.error()

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

WritableStreamDefaultController インターフェイスの error() メソッドにより、関連するストリームとの今後のやり取りがエラーになります。

通常、基になるシンクのメソッドの 1 つから拒否された promise を返すだけで十分なため、このメソッドはほとんど使用されません。 ただし、基になるシンクとのやり取りの通常のライフサイクル外のイベントに応答して、ストリームを突然シャットダウンする場合に役立ちます。

構文

writableStreamDefaultController.error(e);

パラメーター

e

今後のやり取りを失敗させたいエラーを表す DOMString。

戻り値

undefined。

例外

TypeError

エラーにしようとしているストリームは WritableStream ではありません。

例

const writableStream = new WritableStream({
  start(controller) {
    // コントローラーで何かをする

    // 必要に応じてストリームをエラーにする
    controller.error('My error is broken');
  },
  write(chunk, controller) {
    ...
  },
  close(controller) {
    ...
  },
  abort(err) {
    ...
  }
});

仕様

Specification
Streams Standard
# ref-for-ws-default-controller-error①

ブラウザーの互換性

BCD tables only load in the browser