$.ajax()中的请求参数详解

一、回调函数（参数）

 1.beforeSend:在发送请求之前调用，并且传入一个 XMLHttpRequest作为参数在beforeSend中，如果返回false可以取消本次ajax请求。XMLHttpRequest对象是惟一的参数。

     function(XMLHttpRequest){

               this;  //调用本次ajax请求时传递的options参数

   }

 2.error :在请求出错时调用。传入 XMLHttpRequest对象，描述错误类型的字符串以及一个异常对象（如果有的话）

function(XMLHttpRequest,textStatus, errorThrown){

         //通常情况下textStatus和errorThrown只有其中一个包含信息

         this;   //调用本次ajax请求时传递的options参数

  }

 

3. dataFilter : 在请求成功之后调用。传入返回的数据以及"dataType" 参数的值。并且必须返回新的数据（可能是处理过的）传递给success 回调函数。

 function(data,type){

               //返回处理后的数据

               return data;

           }

4.success: 当请求之后调用。传入返回后的数据，以及包含成功代码的字符串。

 $.ajax({

 url:"请求地址",

  type:"GET,

 success:function(arguments){

  //请求发送成功之后进行的操作,方法中可带参数

}

5.complete: 当请求完成之后调用这个函数，无论成功或失败。传入 XMLHttpRequest 对象，以及一个包含成功或错误代码的字符串。如果同时设置了success或error，则在它们执行完之后才执行complete中的回调函数。

function(XMLHttpRequest,textStatus){

this;   //调用本次ajax请求时传递的options参数

}

二、重要参数

1. url:  发送请求地址，为String类型，默认为当前页地址。

2.type: 发送请求类型，GET、POST、(PUT      、DELETE)(支持部分浏览器)，

默认为GET请求。

3.data: 发送数据。类型为String或者Object类型。

       ①.当请求方式为GET时，可用url+?+“数据”来发送数据。

       ②.当数据为键值对：data:{"key1":"value1","key2","value2"};

       ③.当数据为多个用字符串：data:"data1="+data1+"&data2="+data2;

       ④.当数据为对象时：data: $("#提交表单id  form").serialize();

4. async :发送异步请求，为Boolean类型，默认值为true，为异步请求，如果要发送同步请求，则设为false，注意：如果设置为fasle，将会锁定浏览器，用户的其他操作将会等待请求完成之后才能执行。

5. dataType:预期服务器返回的数据类型。为String类型。如果不指定，http包MIME(多用途互联网邮件扩展，一种技术规范,用来处理传送到浏览器中的文档)信心进行智能判断。比如 XML MIME 类型就被识别为 XML。在 1.4 中，JSON 就会生成一个 JavaScript 对象，而 script 则会执行这个脚本。随后服务器端返回的数据会根据这个值解析后，传递给回调函数。其中，text 和 xml 类型返回的数据不会经过处理。数据仅仅简单的将 XMLHttpRequest 的 responseText .sponseHTML 属性传递给 success 回调函数。可用值为：

       "xml":返回 XML 文档，可用 jQuery 处理。

       "html":返回纯文本 HTML 信息；包含的 script 标签会在插入 dom 时执行，数据就以文本形式来对待。

       "script":返回纯文本 JavaScript 代码。不会自动缓存结果。除非设置了 "cache" 参数。注意：在远程请求时(不在同一个域下)，所有 POST 请求都将转为 GET 请求。（因为将使用 DOM 的 script标签来加载）

       "json":返回 JSON 数据，实现这个目的，它首先尝试使用 JSON.parse()。如果浏览器不支持，则使用一个函数来构建。

       "jsonp":JSONP 格式。使用 JSONP 形式调用函数时，如 "myurl?callback=?" jQuery 将自动替换 ? 为正确的函数名，以执行回调函数。

       "text":返回纯文本字符串

6. timeout: 为Number类型，用来设置请求超时时间(毫秒)，此设置将覆盖$.ajaxSetUp()方法的全局设置.,一般会设置为默认值

7. cache: 为Boolean类型的参数，默认值为true，设置为false将不会从浏览器缓存中 加载请求信息（当dataType为script时，默认值为false）

8. content: 为String类型，用于设置ajax相关回调函数的上下文，让回调函数内的this指向你所设定的参数，如果不指定，this就会指向本次ajax请求时传递的options参数， 此时的this就是你所指定的content值，即document.body如：

   $.ajax({

       url: "test.html",

       content:document.body,

       success:fuction(){

   $(this).addClass("done");  

}

})

9. global: 为Boolean类型的参数，默认值为true。用来控制是否触发ajax事件，设置为false将不会触发全局ajax事件，ajaxStart或ajaxStop可用来控制各种ajax事件。global选项用于阻止响应注册的回调函数，比如 .ajaxSend，或者ajaxError，以及类似的方法。这在有些时候很有用，比如发送的请求非常频繁且简短的时候，就可以在 ajaxSend 里禁用这个

10.  username: 为String类型，用来响应HTTP 访问认证请求的用户名。

11.  password：为String类型，用来响应HTTP访问认证请求的密码。

如果服务器需要 HTTP认证，可以使用用户名和密码可以通过 username和 password 选项来设置。

12.  ifModified：为Boolean类型，在服务器数据改变时获取新数据。默认值: false。判断数据自从上次请求后没有更改过就报告出错的话，可以设置 ifModified为 true。

14. jsonpCallback : 为String类型，为 jsonp 请求指定一个回调函数名。这个值将用来取代 jQuery 自动生成的随机函数名。这主要用来让 jQuery 生成度独特的函数名，这样管理请求更容易，也能方便地提供回调函数和错误处理。你也可以在想让浏览器缓存 GET 请求的时候，指定这个回调函数名。

15. processData : 为Boolean类型，默认值: true。默认情况下，通过data选项传递进来的数据，如果是一个对象(技术上讲只要不是字符串)，都会处理转化成一个查询字符串，以配合默认内容类型"application/x-www-form-urlencoded"。如果要发送 DOM 树信息或其它不希望转换的信息，请设置为 false。

16. scriptCharset: 为String类型，只有当请求时 dataType 为 "jsonp" 或 "script"，并且 type 是"GET" 才会用于强制修改 charset。通常只在本地和远程的内容编码不同时使用。

scriptCharset允许给 <script> 标签的请求设定一个特定的字符集，用于 script 或者 jsonp 类似的数据。当脚本和页面字符集不同时，这特别好用

 

17. traditional: 为Boolean类型，如果想用传统的方式来序列化数据，就设置为true。

18. xhr: 为Function类型,需要返回一个XMLHttpRequest 对象。默认在 IE 下是 ActiveXObject 而其他情况下是 XMLHttpRequest 。用于重写或者提供一个增强的 XMLHttpRequest 对象。这个参数在 jQuery 1.3 以前不可用。

19. options ：为object类型，ajax请求设置