SYNCERのロゴ
アイキャッチ画像

XMLHttpRequestEventTarget - ajax通信のイベントハンドラ

XMLHttpRequestEventTargetは、ajax通信の各イベントハンドラを実装するインターフェイスです。

概要

名前
XMLHttpRequestEventTarget
継承
IDL
[Exposed=(Window,DedicatedWorker,SharedWorker)]
interface XMLHttpRequestEventTarget : EventTarget {
  // event handlers
  attribute EventHandler onloadstart;
  attribute EventHandler onprogress;
  attribute EventHandler onabort;
  attribute EventHandler onerror;
  attribute EventHandler onload;
  attribute EventHandler ontimeout;
  attribute EventHandler onloadend;
};

typedef EventHandlerNonNull? EventHandler;

callback EventHandlerNonNull = any (Event event);
仕様書
https://xhr.spec.whatwg.org/#xmlhttprequesteventtarget

チュートリアル

XMLHttpRequestEventTargetは、XMLHttpRequestUploadXMLHttpRequestが継承しています。アップロード時とダウンロード時、それぞれに同じようにイベントを設定できるということです。

// ダウンロード時
var xmlHttpRequest = new XMLHttpRequest() ;
xmlHttpRequest.onloadstart = callbackFn ;
xmlHttpRequest.onload = callbackFn ;
xmlHttpRequest.onloadend = callbackFn ;
xmlHttpRequest.onprogress = callbackFn ;
xmlHttpRequest.onerror = callbackFn ;
xmlHttpRequest.ontimeout = callbackFn ;
xmlHttpRequest.onabort = callbackFn ;

// アップロード時
var xmlHttpRequestUpload = xmlHttpRequest.upload ;
xmlHttpRequestUpload.onloadstart = callbackFn ;
xmlHttpRequestUpload.onload = callbackFn ;
xmlHttpRequestUpload.onloadend = callbackFn ;
xmlHttpRequestUpload.onprogress = callbackFn ;
xmlHttpRequestUpload.onerror = callbackFn ;
xmlHttpRequestUpload.ontimeout = callbackFn ;
xmlHttpRequestUpload.onabort = callbackFn ;

コンストラクタ

コンストラクタはありません。

プロパティ

固有のプロパティはありません。

メソッド

固有のメソッドはありません。

定数

固有の定数はありません。

イベント

onabort

ajax通信を中断した時に発火します。

onerror

ajax通信がエラーで失敗した時に発火します。

onload

ajax通信が正常に完了した時に発火します。

onloadend

ajax通信が成功か失敗に関わらず終了した時に発火します。

onloadstart

ajax通信を開始した時に発火します。

onprogress

ajax通信中に繰り返し発火します。

ontimeout

ajax通信が時間切れにより終了した時に発火します。

サポート状況

クリックすると、バージョンごとの対応状況を確認できます。

FeaturesChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
XMLHttpRequestEventTarget 7+
onabort 10+
onerror 10+
onload 7+
onloadend 18+ 5+ 6.0+ 10+ 16+ 6.0+ 4.4+
onloadstart 10+
onprogress 10+
ontimeout 29+ 12+ 7.1+ 8+ 16+ 7.0+ 4.4+
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月20日 (金)
コンテンツを公開しました。