AbortSignal.prototype.throwIfAborted

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

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

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

Explainers: Discussion: https://github.com/whatwg/dom/issues/927 Examples: https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/throwIfAborted

View on chromestatus.com