XMLHttpRequest: abort() メソッド

Baseline Widely available

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

XMLHttpRequest.abort() メソッドは、すでに送信されたリクエストを中止します。リクエストが中止されたら、 readyStateXMLHttpRequest.UNSENT (0) に変化し、リクエストの status コードが 0 に設定されます。

構文

js
abort()

引数

なし。

返値

なし (undefined)。

この例では、 MDN のホームページからコンテンツを読み込み始め、ある条件が発生したときに、 abort() を呼び出すことで転送を中止します。

js
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();
}

仕様書

Specification
XMLHttpRequest Standard
# the-abort()-method

ブラウザーの互換性

BCD tables only load in the browser

関連情報