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

XMLHttpRequestEventTarget.onerror - ajax通信に失敗した時に発火するイベント

onerrorは、XMLHttpRequestEventTargetのイベントです。ajax通信がエラーで失敗した時にerrorイベントが発生し、ここに設定したコールバック関数が呼び出されます。

概要

名前
onerror
所属
XMLHttpRequestEventTarget
イベント
error
IDL
attribute EventHandler onerror;

typedef EventHandlerNonNull? EventHandler;

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

説明

エラーは例えば同一オリジンポリシーに違反した時に発生します。

ステータスコード404のレスポンスを受け取った場合はエラーは発生しません。

チュートリアル

onerrorでイベントを設定する例です。

var xmlHttpRequest = new XMLHttpRequestEventTarget() ;
xmlHttpRequest.onerror = function ( event ) {
	console.log( event ) ;
}

Event.addEventListener()でも、同様にイベントを設定できます。

xmlHttpRequest.addEventListener( "error", function ( event ) {
	console.log( event ) ;
} ) ;

デモ

XMLHttpRequestEventTarget.onerrorのデモです。ボタンをクリックすると、あえて、別オリジンのファイルをダウンロードしようとして失敗します。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<html>
<head>
<style>
body { word-break: break-all ; tab-size: 2 ; }
div#result { white-space: pre-wrap ; }
</style>
</head>
<body>
<p><button id="send">通信 [send()]</button></p>
<hr>
<img src="" id="hoge" width="120" height="auto">
<hr>
<div id="result"></div>
<script>
var xmlHttpRequest = new XMLHttpRequest() ;
xmlHttpRequest.responseType = "blob" ;

xmlHttpRequest.onloadstart = function ( event ) {
	appendText( "[loadstart] ダウンロードを開始しました!!" + "\n" ) ;
}

xmlHttpRequest.onprogress = function ( event ) {
	appendText( "[progress] ダウンロード中…" + "\n" ) ;
}

xmlHttpRequest.onload = function ( event ) {
	appendText( "[load] ダウンロードが正常に完了しました!!" + "\n" ) ;
}

xmlHttpRequest.onloadend = function ( event ) {
	appendText( "[loadend] ダウンロードを終了しました!!" + "\n" ) ;
}

xmlHttpRequest.onerror = function ( event ) {
	console.log( event ) ;
	appendText( "[error] ダウンロードに失敗しました…。" + "\n" ) ;
}

document.getElementById( "send" ).onclick = function () {
	xmlHttpRequest.open( "GET", "https://www.yahoo.com/image.png" ) ;
	xmlHttpRequest.send() ;
}

function appendText ( text ) {
	document.getElementById( "result" ).appendChild( document.createTextNode( text ) ) ;
}
</script>
</body>
</html>

サポート状況

ChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
10+
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月20日 (金)
コンテンツを公開しました。