English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
$ .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」値を指定 |
data | PlainObjectまたは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オブジェクトを作成するための関数 |