jQuery.ajaxSetup() 関数は、AJAX のグローバルなデフォルト設定を設定するために使用されます。 jQuery.ajaxSetup()函数用于设置AJAX的全局默认设置。
该函数用于更改jQuery中AJAX请求的默认设置选项。之后执行的所有AJAX请求，如果对应的选项参数没有设置，将使用更改后的默认设置。
该函数属于全局jQuery对象。
jQuery 1.1 新增该静态函数。
jQuery.ajaxSetup( settings )
| 参数 | 描述 |
|---|---|
| settings | Object类型一个对象，其中的每个属性表示需要更改默认设置的选项，属性值表示更改后的默认值。 |
关于settings参数可以识别的属性，请参考jQuery.ajax()中的settings参数说明。其中的所有选项参数都是可选设置的。
下面的表格中列出了可能的名称/值：
| 名称 | 值/描述 |
|---|---|
| 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 对象的函数。 |
jQuery.ajaxSetup()函数没有返回值，或者说其返回值为undefined
jQuery オブジェクトに属します。 構文🎜🎜jQuery 1.1 では、この 静的関数が追加されています。 🎜<span class="com">//设置AJAX的全局默认选项<span class="pln"><br/>$<span class="pun">.<span class="pln">ajaxSetup<span class="pun">(<span class="pln"> <span class="pun">{<span class="pln"><br/> url<span class="pun">:<span class="pln"> <span class="str">"/index.html"<span class="pln"> <span class="pun">,<span class="pln"> <span class="com">// 默认URL<span class="pln"><br/> aysnc<span class="pun">:<span class="pln"> <span class="kwd">false<span class="pln"> <span class="pun">,<span class="pln"> <span class="com">// 默认同步加载<span class="pln"><br/> type<span class="pun">:<span class="pln"> <span class="str">"POST"<span class="pln"> <span class="pun">,<span class="pln"> <span class="com">// 默认使用POST方式<span class="pln"><br/> headers<span class="pun">:<span class="pln"> <span class="pun">{<span class="pln"> <span class="com">// 默认添加请求头<span class="pln"><br/> <span class="str">"Author"<span class="pun">:<span class="pln"> <span class="str">"CodePlayer"<span class="pln"> <span class="pun">,<span class="pln"><br/> <span class="str">"Powered-By"<span class="pun">:<span class="pln"> <span class="str">"CodePlayer"<span class="pln"><br/> <span class="pun">}<span class="pln"> <span class="pun">,<span class="pln"><br/> error<span class="pun">:<span class="pln"> <span class="kwd">function<span class="pun">(<span class="pln">jqXHR<span class="pun">,<span class="pln"> textStatus<span class="pun">,<span class="pln"> errorMsg<span class="pun">){<span class="pln"> <span class="com">// 出错时默认的处理函数<span class="pln"><br/> <span class="com">// jqXHR 是经过jQuery封装的XMLHttpRequest对象<span class="pln"><br/> <span class="com">// textStatus 可能为： null、"timeout"、"error"、"abort"或"parsererror"<span class="pln"><br/> <span class="com">// errorMsg 可能为： "Not Found"、"Internal Server Error"等<span class="pln"><br/><br/> <span class="com">// 提示形如：发送AJAX请求到"/index.html"时出错[404]：Not Found<span class="pln"><br/> alert<span class="pun">(<span class="pln"> <span class="str">'发送AJAX请求到"'<span class="pln"> <span class="pun">+<span class="pln"> <span class="kwd">this<span class="pun">.<span class="pln">url <span class="pun">+<span class="pln"> <span class="str">'"时出错['<span class="pln"> <span class="pun">+<span class="pln"> jqXHR<span class="pun">.<span class="pln">status <span class="pun">+<span class="pln"> <span class="str">']：'<span class="pln"> <span class="pun">+<span class="pln"> errorMsg <span class="pun">);<span class="pln"> <br/> <span class="pun">}<span class="pln"><br/><span class="pun">}<span class="pln"> <span class="pun">);</span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span>| パラメータ | 説明 |
|---|---|
| 設定 | オブジェクト クラス は、各属性がデフォルト設定を変更する必要があるオプションを表し、属性値が変更されたデフォルト値を表すオブジェクトです。 |
settings パラメータで認識できるプロパティについては、jQuery.ajax( ) の設定パラメータの説明。すべてのオプションパラメータはオプションです。 🎜🎜可能な名前/値を以下の表に示します: 🎜🎜 🎜| 名前 | 値/説明 |
|---|---|
| async | を表すブール値リクエストが非同期で処理されるかどうか。デフォルトは true です。 |
| beforeSend(xhr) | リクエストを送信する前に実行される関数。 |
| cache | ブラウザがリクエストされたページをキャッシュするかどうかを示すブール値。デフォルトは true です。 |
| complete(xhr, status) | リクエストが完了したときに実行される関数 (リクエストが成功または失敗した後に呼び出されます) 、つまり成功関数とエラー関数の後)。 |
| 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 内のコールバック関数の名前を指定します。 |
| パスワード | HTTP アクセス認証リクエストで使用するパスワードを指定します。 |
| processData | リクエストによって送信されたデータをクエリ文字列に変換するかどうかを指定するブール値。デフォルトは true です。 |
| scriptCharset | リクエストされたキャラクターセット。 |
| success(result,status,xhr) | リクエストが成功したときに実行される関数。 |
| timeout | ローカルリクエストのタイムアウトをミリ秒単位で設定します。 |
| traditional | パラメータのシリアル化の従来のスタイルを使用するかどうかを指定するブール値。 |
| type | リクエストのタイプ (GET または POST) を指定します。 |
| url | リクエストを送信する URL を指定します。デフォルトは現在のページです。 |
| username | HTTP アクセス認証リクエストで使用されるユーザー名を指定します。 |
| xhr | XMLHttpRequest オブジェクトの作成に使用される関数。 |
jQuery.ajaxSetup()関数には戻り値がありません。または、戻り値 値は 未定義です。 🎜🎜例と説明🎜🎜 🎜<span class="pln">$<span class="pun">.<span class="pln">ajax<span class="pun">(<span class="pln"> <span class="pun">{<span class="pln"><br/> url<span class="pun">:<span class="pln"> <span class="str">"myurl.php?action=list"<span class="pln"> <span class="pun">,<span class="pln"><br/> type<span class="pun">:<span class="pln"> <span class="str">"GET"<span class="pln"> <span class="pun">,<span class="pln"><br/> success<span class="pun">:<span class="pln"> <span class="kwd">function<span class="pun">(<span class="pln"> data<span class="pun">,<span class="pln"> textStatus<span class="pun">,<span class="pln"> jqXHR <span class="pun">){<span class="pln"><br/> alert<span class="pun">(<span class="str">"返回数据："<span class="pln"> <span class="pun">+<span class="pln"> data<span class="pun">);<span class="pln"><br/> <span class="pun">}<span class="pln"> <span class="pun">,<span class="pln"><br/> error<span class="pun">:<span class="pln"> <span class="kwd">function<span class="pun">(<span class="pln">jqXHR<span class="pun">,<span class="pln"> textStatus<span class="pun">,<span class="pln"> errorMsg<span class="pun">){<span class="pln"><br/> alert<span class="pun">(<span class="str">"自己的error!"<span class="pun">);<span class="pln"> <br/> <span class="pun">}<span class="pln"><br/><span class="pun">});</span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span>以上がjQuery.ajaxSetup() の使用例を理解します。の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。
![[Web フロントエンド] Node.js クイック スタート](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
