AbortSignal: reason property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2019.

Note: This feature is available in Web Workers.

The reason read-only property returns a JavaScript value that indicates the abort reason.

The property is undefined when the signal has not been aborted. It can be set to a specific value when the signal is aborted, using AbortController.abort() or AbortSignal.abort(). If not explicitly set in those methods, it defaults to "AbortError" DOMException.

Value

A JavaScript value that indicates the abort reason, or undefined, if not aborted.

Examples

In the following snippet, we create a new AbortController object, and get its AbortSignal (available using the signal property). Later on, using the aborted property, we check whether or not the signal has been aborted, and log the abort status and reason to the console.

js
const controller = new AbortController();
const signal = controller.signal;

// …

if (signal.aborted) {
  if (signal.reason) {
    console.log(`Request aborted with reason: ${signal.reason}`);
  } else {
    console.log("Request aborted but no reason was given.");
  }
} else {
  console.log("Request not aborted");
}

Specifications

Specification
DOM
# ref-for-dom-abortsignal-reason①

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
reason

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Has more compatibility info.

See also