AbortSignal.prototype.throwIfAborted

Category: DOM
Type: Chromium catches up
Status: Enabled by default (Chrome 100)
Intent stage: Shipped

Breaking change: No
Enterprise impact: None
Chromium flag: --enable-blink-features=AbortSignalThrowIfAborted
Spec maturity: Published standard
Web Platform Tests: Yes

WPT details: https://wpt.fyi/results/dom/abort/event.any.html?label=master&label=experimental&aligned&q=dom%2Fabort

Summary

Throws an AbortSignal's reason if the signal is aborted. This convenience method can be used by signal-handling functions to check a signal's abort status and propagate the abort reason, e.g. after async operations that might change a signal's state.

Motivation

AbortSignal-handling functions often need to check the signal's status and propagate the error if the signal has been aborted. AbortSignal.throwIfAborted provides a convenient and consistent way to do this.

Standards & signals

Specification: https://dom.spec.whatwg.org/#dom-abortsignal-throwifaborted
Firefox: Shipped/Shipping
Safari: Shipped/Shipping
Web developers: Positive — Minor positive feedback (likes) from announcement tweets: - Safari: https://twitter.com/chris_dumez/status/1469566206516424704 - Node: https://twitter.com/simonplend/status/1487053107720859648 and https://twitter.com/jasnell/status/1466093594129756166
Tracking bug: https://bugs.chromium.org/p/chromium/issues/detail?id=1273458

Ecosystem

Web Platform Tests: https://wpt.fyi/results/?q=dom%2Fabort
Chrome Platform Showcase: https://chrome-platform-showcase.paulkinlan-ea.deno.net/features
GenDN reference: https://gendn.paulkinlan-ea.deno.net/features
chrome.dev demos search: https://www.google.com/search?q=site%3Achrome.dev+AbortSignal.prototype.throwIfAborted
MDN Web Docs: https://developer.mozilla.org/en-US/search?q=AbortSignal.prototype.throwIfAborted
Baseline status: https://webstatus.dev/?q=AbortSignal.prototype.throwIfAborted

Samples: https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/throwIfAborted#examples

View on chromestatus.com