jQuery ajaxSetup() メソッド

❮ jQuery AJAX メソッド

全ての AJAX リクエストにデフォルトの URL と、成功したときの関数を設定する:

$("button").click(function(){
    $.ajaxSetup({url: "demo_ajax_load.txt", success: function(result){
        $("div").html(result);}});
    $.ajax();
});
Try it Yourself »

定義と用法

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


構文

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

ajaxSetup() メソッドは、実行時点以降の AJAX リクエストにデフォルト値を設定します。

指定可能な名前/値は、下表の通り:

名前 値/説明
async リクエストを非同期に処理するかどうかを指定するブール値。デフォルトは true
beforeSend(xhr) リクエストを送信する前に実行する関数t
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 オブジェクトを作成するために使用する関数

Try it Yourself - 例

AJAX リクエストのエラーハンドラを指定する
AJAX リクエストのエラーハンドラを指定するため、error 設定を使用する方法。


❮ jQuery AJAX メソッド