ajaxComplete(handler)


version 1.0 以降

解説

Ajaxリクエストが完了した時に実行するコールバック関数を登録します。

globalオプションがtrueの場合に、ローカルAjaxイベントのcompleteコールバック関数が実行された後に実行されます。 共通の通信完了時の処理を登録する場合に使用します。

引数

  • callback : リクエストが完了した時に実行されるコールバック関数。
    このコールバック関数には 3つの引数が渡されます。
    引数 説明
    event イベントオブジェクト
    参照:イベントオブジェクト
    XMLHttpRequest XMLHttpRequestオブジェクト
    options Ajax通信オプション

戻り値

  • jQueryオブジェクト

例1:サーバ上にある test_get.php を取得し、内容を表示します。 通信完了後、通信が完了した旨のメッセージを表示します。

test_get.php
<p>このデータは、サーバ上にあります。</p>

$(function(){ // DOM準備完了
    // Ajax通信完了時のコールバック関数を登録
    $("#test_result").ajaxComplete(function(event, XMLHttpRequest, options){
        $(this).append("<p>----- ajaxComplete: 通信が完了しました -----</p>");
    });
});

$.get("test_get.php", null, function(data, status){
    $("#test_result").append(data);
});