English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

jQuery ajaxSetup() メソッド

jQueryのAjaxメソッド

$ .ajaxSetup()メソッドは、将来のAjaxリクエストにデフォルト値を設定します。

各呼び出しでオーバーライドされるまで、新しい設定を使用するすべての方法による後続のAjax呼び出しは、次回の$.ajaxSetup()呼び出しまで使用されます。

文法:

$.ajaxSetup({name:value, name:value, ...})

すべてのAJAXリクエストのデフォルトURLを設定します:

$.ajaxSetup({
  url: "ajax_post.php"
});
//現在、Ajaxリクエストを送信するたびに、自動的に「 ajax_post.php」URLが使用されます:
$.ajax({
  data: {fname:"Seagull", lname:"Anna"},
  method: "POST",
  success: function(response){
    $("div").html(response);
  }
});
テストをしてみて‹/›

すべてのAJAXリクエストにデフォルトのURLと成功関数を設定します:

$.ajaxSetup({
  url: "ajax_data.txt",
  success: function(response){
    $("div").html(response);
  }
});
$("button").click(function(){
  $.ajax();
});
テストをしてみて‹/›

Ajaxリクエストがエラーになった場合、通知を表示します:

$.ajaxSetup({
  url: "wrong_file.html",
  success: function(response){
    $("div").html(response);
  },
  error: function(xhr){
    $("div").html("エラーが発生しました: " + xhr.status + " " + xhr.statusText);
  }
});
$("button").click(function(){
  $.ajax();
});
テストをしてみて‹/›

注意:ここで指定された設定は、以下のものに影響を与えます。$ .ajaxまたはAjaxに基づく派生クラス(例えば、$ .get()のすべての呼び出し。他の呼び出し者(プラグインなど)が通常のデフォルト設定を使用することを期待しているため、これは悪い挙動につながる可能性があります。したがって、強くお勧めします$ .ajaxSetup()メソッドを使用しないこと。代わりに、オプションを明示的に設定したり、シンプルなプラグインを定義することをお勧めします。

パラメータの値

パラメータを使用してAJAXリクエストの設定を指定。name:valueのペア

可能な名前:以下の値:

名前値の型説明
async布尔型リクエストを非同期に処理するかどうかを示す布尔値。デフォルトはtrue
beforeSend(xhr)関数リクエストを送信する前に実行される関数
cache布尔型ブラウザがリクエストのページをキャッシュするかどうかを示す布尔値。デフォルトはtrue
complete(xhr,status)関数リクエストが完了した後に実行される関数(成功およびエラーフュニクションの後に)
contentType布尔値または文字列データをサーバーに送信する際に使用する内容タイプ。デフォルト値は「application」 / x-www-form-urlencoded
context普通のオブジェクトすべてのAJAX関連のカールバック関数に「this」値を指定
dataPlainObjectまたはStringまたはArrayサーバーに送信するデータを指定
dataFilter(data,type)関数XMLHttpRequestの原始応答データを処理する関数
dataType文字列サーバーが予期するデータタイプ
error(xhr,status,error)関数リクエストが失敗したときに実行される関数
global布尔型リクエストが全体的なAJAXイベントハンドラをトリガーするかどうかを指定する布尔値。デフォルトはtrue
ifModified布尔型自前回のリクエスト以来の応答が変更された場合にのみ、リクエストが成功するかどうかを指定する布尔値。デフォルト値はfalse。
jsonp文字列または布尔jsonpリクエストのカールバック関数をオーバーライド
jsonpCallback関数jsonpリクエストのカールバック関数の名前を指定
method文字列リクエストに使用するHTTPメソッド(取得または投稿)。デフォルトはGET
password文字列HTTPアクセス認証リクエストで使用されるパスワードを指定
processData布尔型リクエストとともに送信されるデータをクエリ文字列に変換するかどうかを指定する布尔値。デフォルトはtrue
scriptCharset文字列リクエストの文字セットを指定
statusCode普通のオブジェクト応答が特定のHTTPコードを持っている場合に呼び出される数字HTTPコードと関数のオブジェクト
$ .ajax({
  statusCode:{
    404:function()
      alert("ページが見つかりません");
    }
  }
)
success(response,status,xhr)関数リクエストが成功した場合に実行される関数
timeout数字リクエストのローカルタイムアウト(ミリ秒単位)
traditional布尔型従来のパラメータシリアライゼーションスタイルを使用するかどうかを指定する布尔値
type文字列methodの別名です。methodを使用している場合は1.9jQueryの0.0以前のバージョンでは、typeを使用する必要があります。
url文字列リクエストを送信するURLを指定。デフォルトは現在のページ
username文字列HTTPアクセス認証リクエストで使用するユーザー名を指定
xhr関数XMLHttpRequestオブジェクトを作成するための関数

jQueryのAjaxメソッド