ホームページ > 記事 > ウェブフロントエンド > $.ajax() メソッドのパラメータの詳細な説明

$.ajax() メソッドのパラメータの詳細な説明

jackloveオリジナル: 2018-06-11 17:44:282005ブラウズ

1.url:

は、リクエストの送信先となる文字列型パラメータである必要があります(デフォルトは現在のページアドレスです)。

2.type:
String 型のパラメーターが必要で、リクエストメソッド (post または get) のデフォルトは get です。 put や delete などの他の http リクエストメソッドも使用できますが、一部のブラウザでのみサポートされていることに注意してください。

3.timeout:
タイプ Number のパラメーターが必要で、リクエストのタイムアウト (ミリ秒) を設定します。この設定は、$.ajaxSetup() メソッドのグローバル設定をオーバーライドします。

4.async:
ブール型パラメータが必要です。デフォルト設定は true で、すべてのリクエストは非同期リクエストです。同期リクエストを送信する必要がある場合は、このオプションを false に設定します。同期リクエストはブラウザをロックするため、ユーザーはリクエストが完了するまで他の操作を実行する必要があることに注意してください。

5.cache:
ブール型パラメータが必要です。デフォルトは true (dataType が script の場合、デフォルトは false)、false に設定すると、ブラウザのキャッシュからリクエスト情報がロードされません。

6.data:
サーバーに送信されるデータ、オブジェクト型または文字列型のパラメーターが必要です。文字列でない場合は、自動的に文字列形式に変換されます。取得リクエストは URL に追加されます。この自動変換を防ぐには、processData オプションを表示します。オブジェクトはキー/値形式である必要があります。たとえば、{foo1:"bar1",foo2:"bar2"} は &foo1=bar1&foo2=bar2 に変換されます。配列の場合、JQuery は異なる値に同じ名前を自動的に割り当てます。たとえば、{foo:["bar1","bar2"]} は &foo=bar1&foo=bar2 に変換されます。

7.dataType:
サーバーから返される期待されるデータ型である文字列型のパラメーターが必要です。指定しない場合、JQuery は http パッケージの MIME 情報に基づいて、responseXML または responseText を自動的に返し、それをコールバック関数のパラメーターとして渡します。利用可能な型は次のとおりです:
xml: JQuery で処理できる XML ドキュメントを返します。
html: プレーンテキストの HTML 情報を返します。含まれているスクリプトタグは、DOM に挿入されると実行されます。
script: プレーンテキストの JavaScript コードを返します。結果は自動的にキャッシュされません。キャッシュパラメータが設定されていない限り。 (同じドメインの下ではなく) リモート要求を行う場合、すべての post 要求が get 要求に変換されることに注意してください。
json: JSON データを返します。
jsonp: JSONP形式。 myurl?callback=? などの SONP フォームを使用して関数を呼び出すと、JQuery は最後の「?」を正しい関数名に自動的に置き換えてコールバック関数を実行します。
text: プレーンテキスト文字列を返します。

8.beforeSend:
には Function タイプのパラメーターが必要です。カスタム HTTP ヘッダーの追加など、リクエストを送信する前に XMLHttpRequest オブジェクトの関数を変更できます。 beforeSend で false が返された場合、この ajax リクエストはキャンセルできます。 XMLHttpRequest オブジェクトが唯一のパラメータです。

            function(XMLHttpRequest){
               this;   //调用本次ajax请求时传递的options参数
            }

9.complete:
は Function タイプのパラメーターである必要があります。これは、リクエストの完了後に呼び出される (リクエストが成功または失敗したときに呼び出される) コールバック関数です。パラメータ: XMLHttpRequest オブジェクトと、成功したリクエストの種類を説明する文字列。

          function(XMLHttpRequest, textStatus){
             this;    //调用本次ajax请求时传递的options参数
          }

10.success: 要件は Function タイプのパラメーターです。リクエストが成功した後に呼び出されるコールバック関数には 2 つのパラメーターがあります。
(1) サーバーから返され、dataType パラメーターに従って処理されたデータ。状態 (2) 状態の文字列を記述します。

         function(data, textStatus){
            //data可能是xmlDoc、jsonObj、html、text等等
            this;  //调用本次ajax请求时传递的options参数
         }

11.error:関数タイプのパラメータ、つまりリクエストが失敗したときに呼び出される関数が必要です。この関数には、XMLHttpRequest オブジェクト、エラーメッセージ、キャプチャされたエラーオブジェクト (オプション) という 3 つのパラメータがあります。 ajax イベント関数は次のとおりです:

       function(XMLHttpRequest, textStatus, errorThrown){
          //通常情况下textStatus和errorThrown只有其中一个包含信息
          this;   //调用本次ajax请求时传递的options参数
       }

12.contentType: は文字列型のパラメーターを必要とします。サーバーに情報を送信する場合、コンテンツのエンコーディングタイプはデフォルトで「application/x-www-form-urlencoded」になります。」。このデフォルト値は、ほとんどのアプリケーションに適しています。

13.dataFilter: には、Ajaxによって返された元のデータを前処理する関数であるFunctionタイプのパラメータが必要です。データとタイプの 2 つのパラメータを指定します。 data は Ajax によって返される元のデータで、type は jQuery.ajax を呼び出すときに指定される dataType パラメーターです。関数によって返された値は、jQuery によってさらに処理されます。

            function(data, type){
                //返回处理后的数据
                return data;
            }

14.dataFilter: Ajax から返された元のデータを前処理する関数である Function タイプのパラメーターが必要です。データとタイプの 2 つのパラメータを指定します。 data は Ajax によって返される元のデータで、type は jQuery.ajax を呼び出すときに指定される dataType パラメーターです。関数によって返された値は、jQuery によってさらに処理されます。

            function(data, type){
                //返回处理后的数据
                return data;
            }

15.global: ブール型パラメータが必要です。デフォルトは true です。グローバル ajax イベントをトリガーするかどうかを示します。 false に設定すると、グローバル ajax イベントはトリガーされません。ajaxStart または ajaxStop を使用して、さまざまな ajax イベントを制御できます。

16.ifModified：
要求为Boolean类型的参数，默认为false。仅在服务器数据改变时获取新数据。服务器数据改变判断的依据是Last-Modified头信息。默认值是false，即忽略头信息。

17.jsonp：
要求为String类型的参数，在一个jsonp请求中重写回调函数的名字。该值用来替代在"callback=?"这种GET或POST请求中URL参数里的"callback"部分，例如{jsonp:'onJsonPLoad'}会导致将"onJsonPLoad=?"传给服务器。

18.username：
要求为String类型的参数，用于响应HTTP访问认证请求的用户名。

19.password：
要求为String类型的参数，用于响应HTTP访问认证请求的密码。

20.processData：
要求为Boolean类型的参数，默认为true。默认情况下，发送的数据将被转换为对象（从技术角度来讲并非字符串）以配合默认内容类型"application/x-www-form-urlencoded"。如果要发送DOM树信息或者其他不希望转换的信息，请设置为false。

21.scriptCharset：
要求为String类型的参数，只有当请求时dataType为"jsonp"或者"script"，并且type是GET时才会用于强制修改字符集(charset)。通常在本地和远程的内容编码不同时使用。

案例代码：

$.ajax() メソッドのパラメータの詳細な説明

$(function(){
    $('#send').click(function(){
         $.ajax({
             type: "GET",
             url: "test.json",
             data: {username:$("#username").val(), content:$("#content").val()},
             dataType: "json",
             success: function(data){
                         $('#resText').empty();   //清空resText里面的所有内容
                         var html = ''; 
                         $.each(data, function(commentIndex, comment){
                               html += '<p></p><h6>' + comment['username']                                         + ':</h6><p></p>';
                         });
                         $('#resText').html(html);
                      }
         });
    });
});

22.顺便说一下$.each()函数:
$.each()函数不同于JQuery对象的each()方法，它是一个全局函数，不操作JQuery对象，而是以一个数组或者对象作为第1个参数，以一个回调函数作为第2个参数。回调函数拥有两个参数：第1个为对象的成员或数组的索引，第2个为对应变量或内容。

本文介绍了$.ajax()方法参数，更多相关内容请关注php中文网。

$.ajax() メソッドのパラメータの詳細な説明

関連記事