jQuery ajaxSetup()メソッド

jQuery AJAX 方法jQuery AJAX メソッド

サンプル

すべての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 方法jQuery AJAX メソッド

その他の拡張