Firefox Tomorrow

web api instance method

XMLHttpRequest: abort() method

View on MDN ↗

Available in workers

The XMLHttpRequest.abort() method aborts the request if it has already been sent. When a request is aborted, its readyState is changed to XMLHttpRequest.UNSENT (0) and the request’s status code is set to 0.

If the request is still in progress (its readyState is not XMLHttpRequest.DONE or XMLHttpRequest.UNSENT), a readystatechange event, abort, and a loadend event are dispatched, in that order. For synchronous requests, no events are dispatched and an error is thrown instead.

Syntax

abort()

Parameters

None.

Return value

None (undefined).

Examples

This example begins loading content from the MDN home page, then due to some condition, aborts the transfer by calling abort().

const xhr = new XMLHttpRequest();
const method = "GET";
const url = "https://developer.mozilla.org/";
xhr.open(method, url, true);

xhr.send();

if (OH_NOES_WE_NEED_TO_CANCEL_RIGHT_NOW_OR_ELSE) {
  xhr.abort();
}

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also