jQuery ajaxSetup()メソッド
サンプル
すべてのAJAXリクエストにデフォルトのURLとsuccess関数を設定します:
$("button").click(function(){
$.ajaxSetup({
url:"demo_ajax_load.txt",
success:function(result){
$("div").html(result);
}
});
$.ajax();
});
試してみる »
定義と使い方
ajaxSetup() メソッドは、将来のAJAXリクエストのデフォルト値を設定します。
構文
$.ajaxSetup({name:value, name:value, ... })
このパラメータは、1つ以上の名前/値のペアを持つAJAXリクエストの設定を指定します。
以下の表に、可能な名前/値を示します:
| 名前 | 値/説明 |
|---|---|
| async | リクエストが非同期に処理されるかどうかを示すブール値。デフォルトは true。 |
| beforeSend(xhr) | リクエスト送信前に実行される関数。 |
| cache | ブラウザがリクエストされたページをキャッシュするかどうかを示すブール値。デフォルトは true。 |
| complete(xhr,status) | リクエスト完了時に実行される関数(リクエストの成功または失敗の後に呼び出されます。つまり、success 関数と error 関数の後)。 |
| contentType | サーバーにデータを送信するときに使用されるコンテンツタイプ。デフォルトは:"application/x-www-form-urlencoded"。 |
| context | すべてのAJAX関連コールバック関数に "this" 値を指定します。 |
| data | サーバーに送信するデータを指定します。 |
| dataFilter(data,type) | XMLHttpRequest の生のレスポンスデータを処理する関数。 |
| dataType | 予期されるサーバーレスポンスのデータ型。 |
| error(xhr,status,error) | リクエストが失敗した場合に実行される関数。 |
| global | リクエストに対してグローバルなAJAXイベントハンドラをトリガーするかどうかを指定するブール値。デフォルトは true。 |
| ifModified | 最後のリクエスト以降にレスポンスが変更された場合にのみリクエストが成功するかどうかを指定するブール値。デフォルトは false。 |
| jsonp | jsonp でコールバック関数を書き換える文字列。 |
| jsonpCallback | jsonp でコールバック関数の名前を指定します。 |
| password | HTTPアクセス認証リクエストで使用するパスワードを指定します。 |
| processData | リクエストで送信されるデータをクエリ文字列に変換するかどうかを指定するブール値。デフォルトは true。 |
| scriptCharset | リクエストの文字セットを指定します。 |
| success(result,status,xhr) | リクエスト成功時に実行される関数。 |
| timeout | ローカルのリクエストタイムアウト時間を設定します(ミリ秒単位)。 |
| traditional | パラメータのシリアライズに従来のスタイルを使用するかどうかを指定するブール値。 |
| type | リクエストのタイプを指定します(GET または POST)。 |
| url | リクエストを送信するURLを指定します。デフォルトは現在のページ。 |
| username | HTTPアクセス認証リクエストで使用するユーザー名を指定します。 |
| xhr | XMLHttpRequest オブジェクトを作成するための関数。 |
その他のサンプル
AJAXリクエストのエラーハンドラを指定します
エラー設定を使用してAJAXリクエストのエラーハンドラを指定する方法。
その他の拡張
jQuery AJAX メソッド