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 2015年7月.
XMLHttpRequest.abort() メソッドは、すでに送信されたリクエストを中止します。リクエストが中止されたら、 readyState が XMLHttpRequest.UNSENT (0) に変化し、リクエストの status コードが 0 に設定されます。
リクエストがまだ進行中である場合(その readyState が XMLHttpRequest.DONE または XMLHttpRequest.UNSENT でない場合)、 readystatechange イベントと、abort、そして loadend イベントが、この順序で配信されます。同期リクエストの場合、イベントは配信されず、代わりにエラーが発生します。
構文
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> # the-abort()-method> |