型：PlainObject

Ajaxリクエスト設定のためのキーと値のペアを設定します。 全ての設定は任意になります。 デフォルトでは$.ajaxSetup()を使用した設定が使用されます。

型：PlainObject 初期値：DataTypeに依存

サーバーにどの種類のレスポンスを返して欲しいのかを伝える、リクエストヘッダー内に指定されるコンテンツタイプです。

型：Boolean 初期値：true

デフォルトでは、全てのリクエストは非同期です。(デフォルトでtrueのため) もし同期リクエストをする必要があれば、このオプションをfalseにします。 クロスドメイン、またはdataType: "jsonp"のリクエストは、同期操作はサポートされません。 同期リクエストは一時的にブラウザをロックし、リクエスト処理中は全てのアクションが無効になることに注意してください。

jQuery 1.8で、jqXHR($.Deferred)でのasync: falseの使用は非推奨になりました。 jqXHR.done()、または非推奨のjqXHR.success()のような、 jqXHRオブジェクトのメソッドに沿ったsuccess/error/completeのコールバックオプションを使用する必要があります。

型：Function( jqXHR jqXHR, PlainObject settings )

送信される直前にjqXHR(jQuery1.4.xではXMLHTTPRequest)オブジェクトの変更が可能な、コールバック関数です。 これを使用してカスタマイズヘッダーの設定等を行います。 jqXHRとsettingsオブジェクトは引数として渡されます。 これは、Ajaxイベントで、 beforeSend関数からfalseが返されるとリクエストがキャンセルされます。

jQuery 1.5で、beforeSendオプションはリクエストのタイプに関係なく呼び出されるようになりました。

型：Boolean
初期値：true、ただし、dataTypeが'script'または'jsonp'の場合は、false

falseを設定すると、ブラウザによってリクエストされたページを強制的にキャッシュしないようにします。

注意: cacheへのfalse設定は、HEADとGETリクエスト時のみ正しく動作します。 これは"_={timestamp}"をGETパラメーターに追加することで動作します。 このパラメーターは、GETによって既にリクエストされているURLへPOSTする際のIE8を除き(翻訳に自信なし)、 その他のタイプのリクエストでは不要です。

型：Function( jqXHR jqXHR, String textStatus )

リクエストが完了した際に呼び出される関数です。(success、errorのコールバック実行後) この関数は2つの引数を受け取ります。 1つ目はjqXHR(jQuery1.4.xではXMLHTTPRequest)オブジェクトで、 2つ目はtextStatusは、リクエストのステータスを分類するための文字列です。

• "success"
• "notmodified"
• "error"
• "timeout"
• "abort"
• "parsererror"

jQuery 1.5から、completeは関数の配列を受け取れるようになり、 各関数は順に呼び出されます。 これはAjaxイベントです。

型：PlainObject

jQueryによる指定されたコンテンツタイプ毎のそのレスポンスのパース方法を決定する、 文字列/正規表現のオブジェクトのペアとなるオブジェクトです。

型：String 初期値：
'application/x-www-form-urlencoded; charset=UTF-8'

サーバーへデータが送信される際に、ここで指定されたコンテンツタイプが指定されます。 デフォルトは、"application/x-www-form-urlencoded; charset=UTF-8"で、 ほとんどのケースは、これで問題ありません。 もし明示的にcontent-typeを$.ajax()へ渡すと、常にそれがサーバーへ送信されます。(データが送信されない場合でも) W3CのXMLHttpRequestの仕様では、charsetは常にUTF-8であることが指示されており、 その他のcharsetをブラウザにエンコーディングを変更させることを強制しません。(翻訳に自信なし)

型：Object

ここに指定されたオブジェクトが、全てのAjax関連のコールバックのコンテキストにされます。 デフォルトでは、このコンテキストは呼び出し時に使用されるajaxの設定が反映されるオブジェクトになります。 ($.ajaxSettingsとマージされた設定が、$.ajaxに渡されます。) DOMを指定することで、関連するAjaxのコールバック関数全てでthisを指定した際にcontextに指定したDOMが参照されるようになります。 例として、contextとして指定されたDOM要素は、下記のようにリクエストの完了コールバック時のコンテキストになります。

$.ajax({
  url: "test.html",
  context: document.body
}).done(function() {
  $( this ).addClass( "done" );
});

型：PlainObject
初期値：{"* text": window.String, "text html": true, "text json": jQuery.parseJSON, "text xml": jQuery.parseXML})

dataTypeオプション毎のコンバーターを含むオブジェクトです。 各コンバーターの値は、レスポンスの変換された値を返す関数です。 通信後の戻り値はこの関数によってそれぞれパース処理されます。

型：Boolean
初期値：同じドメインのリクエストならfalse、クロスドメインのリクエストならtrue

もし、(JSONPのような)同じドメイン上で強制的にクロスドメインリクエストを行いたい場合、 この値をtrueに設定します。 例えば、サーバサイドで別ドメインへリダイレクトされるような場合は、trueを指定します。

型：PlainObjectまたはString

サーバーへ送信するデータです。 もし文字列で無ければ、クエリー文字列に変換されます。 これはGETリクエストのURLに追加されます。 この自動的に行われるプロセスを防ぎたい場合は、processDataのオプションを参照してください。 オブジェクトは、キー/値のペアでなければいけません。 もし値が配列の場合、jQueryは従来の設定の、値をベースとした同じキーを使用した複数の値のシリアライズを行います。(詳細は後述)

型：Function( String data, String type ) => Object

XMLHttpRequestの生のレスポンスデータを扱うのに使用する関数を指定します。 これは、レスポンスをサニタイズするためのプレ・フィルタリング関数で、 サニタイズされたデーターが返されるべきです。 この関数は2つの引数を受け取り、1つ目はサーバーから返される名前のデータで、 2つ目は'dataType'の値になります。

型：String 初期値：xml,json,script,htmlからjQueryがMIME typeを元に判別

あなたが期待するサーバーから返されるデータの型を指定します。 もし指定されなければ、jQueryはレスポンスのMIME typeを元に推察することを試みます。 (XMLのMIME typeはXMLを生成し、1.4でJSONはJavaScriptオブジェクト、scriptはスクリプトの実行、 その他は文字列として返されるようになりました。) 利用可能な型(そして、successのコールバックへ第1引数として渡される結果)は、下記の通りです。

"xml"

jQueryを介して処理することが可能なXMLドキュメントが返されます。

"html"

プレーンテキストとしてのHTMLを返します。 含まれるscriptタグはDOMに挿入された際に評価されます。

"script"

JavaScriptとしてレスポンスを評価し、プレーンテキストとしてそれを返します。 cacheオプションがtrueに設定されなければ、 URLへクエリー文字列パラメーター"_=[TIMESTAMP]"の追加によるキャッシュの無効化が行われます。

注意:クロスドメイン間の送信ではPOST送信は自動的にGET送信に切り替わります。

"json"

JSONとしてレスポンスを評価し、JavaScriptオブジェクトが返されます。 このJSONデータは厳格な作法によってパースされるため、奇形と判断されたJSONは拒絶され、パースエラーがスローされます。 jQuery1.9からは、空のレスポンスも拒絶されるようになったため、 サーバーは代わりにnullまたは{}を返す必要があります。 正しいJSONのフォーマットについて、より詳しい情報を知りたければ、 json.orgを参照してください。

"jsonp"

JSONPを使用してJSONブロックを読み込みます。 コールバック関数を指定するために、URLの最後に"?callback=?"を追加します。 cacheオプションがtrueに設定されなければ、 URLへクエリー文字列パラメーター"_=[TIMESTAMP]"の追加によるキャッシュの無効化が行われます。

"?callback=?"の部分は、実際にはクエリー文字列で?callback=jQuery1234567890のようなコールバック関数名が指定され、 サーバー側で例えばPHPであれば、$_GET['callback'] . '(' . jsonデータ . ');'と処理することで、 JavaScriptのコールバック関数の実行が出力されます。 ランダムな関数名が割り当てられるのは、他のグローバルなJavaScriptの関数名とバッティングしない等の理由が考えられます。

"text"

プレーンなテキスト文字列です。

複数、空白区切りの値

jQuery1.5からは、jQueryはContent-Type内で受け取ったdataTypeを、あなたが必要とするものに変換出来るようになりました。 例えば、もしテキストのレスポンスをXMLとして取り扱いたい場合は、dataTypeに"text xml"を指定します。

また、"jsonp text xml"とすることで、JSONPリクエストをテキストとして受け取り、 jQueryにXMLとして解釈させることも可能です。(翻訳に自信なし) 同じように"jsonp xml"のような省略された文字列指定を行うと、最初にjsonpからxmlへの変換を試み、 それが失敗するとjsonpからtextへ変換し、次にtextからxmlに変換します。

型：Function( jqXHR jqXHR, String textStatus, String errorThrown )

リクエストが失敗すると呼び出される関数です。 この関数は、jqXHR(jQuery 1.4.xではXMLHttpRequest)オブジェクト、発生したエラーの型を示す文字列、 任意指定の例外オブジェクトの3つの引数を受け取ります。 第2引数に指定される可能のある値は、(nullの他に、)"timeout"、"error"、"abort"、"parsererror"です。 第3引数であるerrorThrownはHTTPエラーが発生した際に、"Not Found"や"Internal Server Error"のような、 HTTPステータスのテキスト部分を受け取ります。 jQuery1.5からは、errorの設定は関数の配列を受け取れるようになり、各関数は順に呼び出されます。

注意: このハンドラはクロスドメイン・スクリプトとクロスドメイン・JSONPリクエストに対しては呼び出されません。

これはAjaxイベントです。

型：Boolean 初期値：true

このリクエストがグローバルAjaxイベントハンドラをトリガするか否かを決定します。 デフォルトはtrueです。 falseに設定すると、ajaxStartやajaxStopのようなグローバルのハンドラがトリガされることを防ぎます。 これは、様々なAjaxイベントを制御するのに使用することが可能です。

型：PlainObject 初期値：{}

XMLHttpRequestを使用した通信に使用するリクエストに沿って送信する、 HTTPリクエストのヘッダーのキー/値のペアの追加オブジェクトを指定します。 X-Requested-With: XMLHttpRequestヘッダーは常に追加されますが、 このデフォルトの値をここで変更することが出来てしまいます。 このheadersの設定での値は、 beforeSend関数によって上書きすることも可能です。

型：Boolean 初期値：false

trueに設定すると、レスポンスが最後のリクエストから変更されている場合のみ、リクエストを成功とみなします。 Last-Modifiedヘッダーを確認することで、それが行われます。 デフォルトの値はfalseで、ヘッダーの内容は無視されます。 jQuery 1.4で、変更されていないデータの確認のためにサーバによって指定される'etag'も確認するようになりました。(翻訳に自信無し)

型：Boolean
初期値：(現在のローカルのプロトコルに依存)

jQueryがデフォルトでそのように判断しなかったとしても、 現在の環境を"ローカル"である(例えばファイルシステム)と認識することを可能とします。 file、*-extension、widgetのプロトコルがローカルであると認識されます。 もし、isLocal設定の変更が必要な場合、 $.ajaxSetup()メソッドでこれを行うことが推奨されています。

型：String

jsonpリクエストのコールバック関数名を上書きするのに使用されます。 この値はURLのクエリー文字列部分'callback=?'の、'callback'の代わりとして使用されます。 そのため例えば{jsonp:'onJSONPLoad'}と指定すると、 クエリー文字列は'onJSONPLoad=?'としてサーバーへ渡されることになります。

jQuery 1.5からは、jsonpオプションをfalseに設定すると、jQueryがURLへ"?callback"文字列を追加することを、 また"=?"を変換する試みを止めさせることが出来るようになりました。 この場合、例えば{ jsonp: false, jsonpCallback: "callbackName" }のようにして、 jsonpCallback設定を明示的に指定する必要があります。

"?callback=?"の部分は、ここでfalseが指定されなければ、 実際にはURLクエリー文字列は?callback=jQuery1234567890のようになり、ここでコールバック関数名が指定され、 サーバー側で例えばPHPであれば、$_GET['callback'] . '(' . jsonデータ . ');'のようにしてコールバック関数が実行されます。 jQuery側では動的にjQuery1234567890という関数が作成されているものと思われます。

型：StringまたはFunction()

JSONPリクエストのためのコールバック関数名を指定します。 この値はjQueryによって自動的に生成されるランダムなコールバック関数名の代わりに使用されます。 ただし、リクエストの管理、コールバック関数の提供、エラーハンドリングが簡潔になることから、 通常はjQueryの自動生成に任せることが推奨されています。 GETリクエストでブラウザキャッシュを有効にしたい場合に、このコールバック名を指定したいというケースがあります。 jQuery1.5からは、この設定に関数も使用できるようになり、その場合はjsonpCallbackの値は、 この関数の戻り値が設定されます。

型：String

XHRのMIME typeを上書きします。

型：String

HTTPアクセスの認証リクエストに応答するXMLHttpRequestに使用されるパスワードを指定します。

型：Boolean 初期値：true

デフォルトでは、dataオプションにオブジェクトとして渡されるデータ(厳密に言えば、文字列以外のもの)は、 デフォルトのcontent-typeである"application/x-www-form-urlencoded"に合わせた形式でクエリー文字列へ変換されます。 もしDOMDocument、またはその他の形式のデータを送信したい場合は、このオプションをfalseに設定します。

型：String

"script"通信での使用時での用途に限られます。 (例えば、"jsonp"、"script"のdataTypeでのクロスドメインへの"GET"リクエスト) scriptタグでのcharset属性の設定は、このリクエストでの指定が使用されます。 ローカルページ上で設定された文字コードと、リモートスクリプト上での文字コードが異なる場合に使用します。

{scriptCharset:"EUC-JP"}

型：PlainObject 初期値：{}

HTTPコードの数値と、それに相当するコードが応答された際に呼び出される関数のオブジェクト(マップ)を指定します。 例えば、404を受け取った場合に、alertダイアログを表示したい場合は下記のように指定します。

$.ajax({
  statusCode: {
    404: function() {
      alert( "page not found" );
    }
  }
});

通信が成功した場合、successコールバックと同じ値を引数として受け取り、 同様に通信が失敗(300番台のリダイレクトも含む)した場合も、errorコールバックと同じ値を引数として受け取ります。

型：Function( PlainObject data, String textStatus, jqXHR jqXHR )

リクエストが成功した祭に呼び出される関数を指定します。 この関数は下記の3つの引数を受け取ります。

data

サーバが返すデータ(例えば、json値など)をdataTYpeに沿ってフォーマットされた値が格納されています。

textStatus

通信の結果により、「"success", "notmodified", "error", "timeout", "abort", "parsererror"」のいずれかが指定されます。

jqXHR

jqXHRオブジェクトです。(jQuery1.4.xまでは、XMLHttpRequestです。)

jQuery1.5からは、successの設定は関数の配列が受け取れるようになりました。 各関数は順に呼び出されます。

このsuccessは、Ajaxイベントです。

型：Number

リクエストのタイムアウト(ミリ秒)で設定します。 これは$.ajaxSetup()によって設定された、 グローバルなタイムアウトを上書きします。 タイムアウトのカウントは$.ajaxが呼び出しが行われた時点で開始され、 もし処理中にその他のリクエストがあり、ブラウザのコネクションが利用出来ないと、 送信が行われる前にリクエストがタイムアウトされることもあります。

jQuery 1.4.x、それ以下のバージョンでは、リクエストがタイムアウトするとXMLHttpRequestオブジェクトは不正(invalid)な状態になり、 オブジェクトのメンバへアクセスしようとすると、例外がスローされるかもしれません。

Firefox 3.0以上のみ、scriptとJSONPのリクエストはタイムアウトによるキャンセルが出来ず、 タイムアウト期限後でもスクリプトが実行されてしまいます。

型：Boolean

従来のパラメーターのシリアル化を使用したいのであれば、これをtrueに設定します。

型：String 初期値：'GET'

リクエストのタイプ("POST"または"GET")を指定します。

注意: PUTやDELETEのような、他のHTTPリクエストメソッドも、ここで指定することが可能ですが、 全てのブラウザでサポートされている保証がありません。

型：String 初期値：現在のページ

リクエストを送信するURLを指定します。

型：String

HTTPアクセスの認証リクエストに応答するXMLHttpRequestに使用されるユーザー名を指定します。

型：Function()
初期値：IEでこれが利用可能な場合はActiveXObject、それ以外はXMLHttpRequest

XMLHttpRequestオブジェクトが生成された際のコールバック関数を指定します。 デフォルトは、ActiveXObject(IE)が利用可能であればそれを、それ以外はXMLHttpRequestになります。 独自実装のXMLHttpRequestの上書きや、ファクトリーによる拡張が可能です。

型：PlainObject

ネイティブのXHRオブジェクト上に設定する、フィールド名/フィールド値のペアのオブジェクトを指定します。 例えば、下記のようにクロスドメインへのリクエストのために、 withCredentialsへtrueを指定することが可能です。

$.ajax({
   url: a_cross_domain_url,
   xhrFields: {
      withCredentials: true
   }
});

jQuery1.5までは、withCredentialsプロパティはネイティブのXHRに伝えられないため、 これを必要とするCORSリクエストは、このフラグを無視していました。 こういった理由から、このようなケースではjQuery 1.5.1以上を使用する事が推奨されています。