W3cubDocs

/Web APIs

AbortSignal: reason property

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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
reason 98 98 97 No 84 15.4 98 98 97 68 15.4 18.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/reason