MDN self-hosted library · e01.org

XMLHttpRequest: abort() method

XMLHttpRequest API windowandworkerexceptservice

XMLHttpRequest API window_and_worker_except_service

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

Browser compatibility

See also