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() メソッドは、すでに送信されたリクエストを中止します。リクエストが中止されたら、 readyState が XMLHttpRequest.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

関連情報