このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
WritableStreamDefaultWriter: abort() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2022年5月以降、すべてのブラウザーで利用可能です。
abort() は WritableStreamDefaultWriter インターフェイスのメソッドで、ストリームを中止し、プロデューサーがストリームに正常に書き込むことができなくなり、キューに書き込まれた書き込みを破棄してすぐにエラー状態に移行することを通知します。
ライターがアクティブな場合、abort() メソッドは、関連するストリーム(WritableStream.abort())と同じように振る舞います。 そうでない場合、拒否されたプロミスを返します。
構文
js
abort()
abort(reason)
引数
reason省略可-
文字列で、人間が読むことができる中止の理由を表します。
返値
Promise です。 reason 引数で指定された値で履行されます。
例外
TypeError-
中止しようとしているストリームが
WritableStreamではないか、ロックされている場合。
例
js
const writableStream = new WritableStream(
{
write(chunk) {
// ...
},
close() {
// ...
},
abort(err) {
// ...
},
},
queuingStrategy,
);
// ...
const writer = writableStream.getWriter();
// ...
// 必要に応じてストリームを中止します
writer.abort.then((reason) => {
console.log(reason);
});
仕様書
| 仕様書 |
|---|
| Streams # ref-for-default-writer-abort4 |
ブラウザーの互換性
ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。