jQuery.ajax使用说明

1、jquery.ajax使用说明jquery.ajax( url , settings )解释: 执行一个异步的http（ajax）的哀求。url类型: string一个用来包含发送哀求的url字符串。settings类型: plainobject一个以"键:值"组成的ajax 哀求设置。全部选项都是可选的。可以用法$.ajaxsetup()设置任何默认参数。看jquery.ajax( settings )下全部设置的完整列表。jquery.ajax( settings )settings类型: plainobject一个以"键:值&

2、quot;组成的ajax 哀求设置。全部选项都是可选的。可以用法$.ajaxsetup()设置任何默认参数。accepts (默认: 取决于数据类型)类型: plainobject内容类型发送哀求头（content-type），用于通知服务器该哀求需要接收何种类型的返回结果。假如accepts设置需要修改，推举在$.ajaxsetup() 办法中设置一次。async (默认: true)类型: boolean默认设置下，全部哀求均为异步哀求（也就是说这是默认设置为 true ）。假如需要发送同步哀求，请将此选项设置为 false 。跨域哀求和 datatype: "jsonp

3、" 哀求不支持同步操作。注重，同步哀求将锁住扫瞄器，用户其它操作必需等待哀求完成才可以执行。从 jquery 1.8 开头, jqxhr ($.deferred)中用法 async: false 已经过时。您必需用法的 success/error/complete 的回调选项代替相应的jqxhr对象的办法，比如jqxhr.done() 或者过时的jqxhr.success()beforesend类型: function( jqxhr jqxhr, plainobject settings )哀求发送前的回调函数，用来修改哀求发送前jqxhr（在jquery 1.4.x的中，x

4、mlhttprequest）对象，此功能用来设置自定义 http 头信息，等等。该jqxhr和设置对象作为参数传递。这是一个ajax大事 。在beforesend函数中返回false将取消这个哀求。从jquery 1.5开头， beforesend选项将被拜访，不管哀求的类型。cache (默认: true, datatype为"script"和"jsonp"时默认为false)类型: boolean假如设置为 false ，扫瞄器将不缓存此页面。注重: 设置cache为 false将在 head和get哀求中正常工作。它

5、的工作原理是在get哀求参数中附加"_=timestamp"（译者注：时光戳）。该参数不是其他哀求所必需的，除了在ie8中，当一个post哀求一个已经用get哀求过的url。complete类型: function( jqxhr jqxhr, string textstatus )哀求完成后回调函数 (哀求success 和 error之后均调用)。这个回调函数得到2个参数： jqxhr (在 jquery 1.4.x中是 xmlhttprequest) 对象和一个描述哀求状态的字符串("success", &qu

6、ot;notmodified", "error", "timeout", "abort", 或者 "parsererror") 。从jquery 1.5开头， complete设置可以接受一个函数的数组。每个函数将被依次调用。这是一个ajax大事 。contents类型: plainobject一个以"字符串/正则表达式"配对的对象，按照给定的内容类型，解析哀求的返回结果。 (1.5新增)conte

7、nttype (默认: &39;application/x-www-form-urlencoded; charset=utf-8&39;)类型: string发送信息至服务器时内容编码类型。默认值是"application/x-www-form-urlencoded; charset=utf-8"，适合大多数状况。假如你明确地传递了一个内容类型（content-type）给 $.ajax()，那么他必然会发送给服务器（即使没有数据要发送）。数据将总是用法utf-8字符集传递给服务器；你必需在服务器端举行适当的解码。context类型: obj

8、ect这个对象用于设置ajax相关回调函数的上下文。 默认状况下，这个上下文是一个ajax哀求用法的参数设置对象，（$.ajaxsettings合并独傲这个设置，传递给$.ajax）。比如指定一个dom元素作为context参数，这样就设置了complete回调函数的上下文为这个dom元素。就像这样：$.ajax(url: "test.html",context: document.body).done(function() $(this).addclass("done"););converters (默认: &q

9、uot;* text": window.string, "text html": true, "text json": jquery.parsejson, "text xml": jquery.parsexml)类型: plainobject一个数据类型到数据类型转换器的对象。每个转换器的值是一个函数，返回经转换后的哀求结果。 ( 1.5新增)crossdomain (默认: 同域哀求为false， 跨域哀求为true)类型: boolean假如你想在同一域中强制跨域哀

10、求（如jsonp形式），例如，想服务器端重定向到另一个域，那么需要将crossdomain设置为 true 。 ( 1.5 新增)data类型: object, string发送到服务器的数据。将自动转换为哀求字符串格式。get 哀求中将附加在 url 后面。查看 processdata 选项解释，以禁止此自动转换。对象必需为"键:值"格式。假如这个参数是一个数组，jquery会根据traditional 参数的值， 将自动转化为一个同名的多值查询字符串(查看下面的解释)。注：如 foo:"bar1", &quot

11、;bar2" 转换为 &39;&foo=bar1&foo=bar2&39;。datafilter类型: function( object data, string type ) => object一个函数被用来处理xmlhttprequest的原始响应数据。这是一个预过滤功能，净化响应。您应当返回平安数据。提供data和type两个参数：data是ajax返回的原始数据，type是调用jquery.ajax时提供的datatype参数。datatype (默认: intelligent guess (xml, json,

12、script, or html)类型: string预期服务器返回的数据类型。假如不指定，jquery 将自动按照 http 包 mime 信息来智能推断，比如xml mime类型就被识别为xml。在1.4中，json就会生成一个javascript对象，而script则会执行这个脚本。随后服务器端返回的数据会按照这个值解析后，传递给回调函数。可用值:"xml": 返回 xml 文档，可用 jquery 处理。."html": 返回纯文本 html 信息；包含的script标签会在插入dom时执行。"sc

13、ript": 把响应的结果当作 javascript 执行。并将其当作纯文本返回。默认状况下不会通过在url中附加查询字符串变量 "_=timestamp" 举行自动缓存结果，除非设置了cache参数为true。note: 在远程哀求时(不在同一个域下)，全部post哀求都将转为get哀求。(由于将用法dom的script标签来加载)"json": 把响应的结果当作 json 执行，并返回一个javascript对象。在 jquery 1.4 中，json 格式的数据以严格的方式解析，假如格式有错误，jq

14、uery都会被否决并抛出一个解析错误的异样。（见的更多信息，正确的json格式。）"jsonp": 以 jsonp 的方式载入 json 数据块。会自动在所哀求的url最后添加 "?callback=?"。默认状况下不会通过在url中附加查询字符串变量 "_=timestamp" 举行自动缓存结果，除非将 cache参数设置为true。"text": 返回纯文本字符串。多个空格分割的值:从 jquery 1.5 开头， jquery可以

15、内容类型（content-type）头收到并转换一个您需要的数据类型。例如，假如你想要一个文本响应为xml处理，用法"text xml"数据类型。您也可以将一个jsonp的哀求，以文本形式接受，并用jquery以xml解析: "jsonp text xml"。同样地可以用法"jsonp xml"简写,首先会尝试从 jsonp 到 xml 的转换，假如转换失败，就先将 jsonp 转换成 text, 然后再由 text 转换成 xml。error类型: function( jqxhr jq

16、xhr, string textstatus, string errorthrown )哀求失败时调用此函数。有以下三个参数：jqxhr (在 jquery 1.4.x前为xmlhttprequest) 对象、描述发生错误类型的一个字符串 和 捕捉的异样对象。假如发生了错误，错误信息（其次个参数）除了得到null之外，还可能是"timeout", "error", "abort" ，和 "parsererror"。 当一个http错误发生时，error

17、thrown 接收http状态的文本部分，比如： "not found"（没有找到） 或者 "internal server error."（服务器内部错误）。 从jquery 1.5开头, 在error设置可以接受函数组成的数组。每个函数将被依次调用。 注重：此处理程序在跨域脚本和jsonp形式的哀求时不被调用。这是一个 ajax event。global (默认: true)类型: boolean无论怎么样这个哀求将触发全局ajax大事处理程序。默认是true 。设置为 false 将不会触发全局 ajax 大事，如

18、ajaxstart 或者 ajaxstop。这可以用来控制各种 ajax event.headers (默认: )类型: plainobject一个额外的"键:值"对映射到哀求一起发送。此设置会在beforesend 函数调用之前被设置 ;因此，哀求头中的设置值，会被beforesend 函数内的设置笼罩 。 (1.5 新增 ）ifmodified (默认: false)类型: boolean惟独上次哀求响应转变时，才允许哀求胜利。用法 http 包 last-modified 头信息推断。默认值是false，忽视http头信息。在jquery 1.4中，他

19、也会检查服务器指定的&39;etag&39;来确定数据没有被修改过。islocal (默认: 取决于当前的位置协议)类型: boolean允许当前环境被认定为本地，（如文件系统），即使jquery默认状况下不会这么做。以下协议目前公认为本地：file, *-extension, and widget。假如islocal设置需要修改，建议在$.ajaxsetup()办法中这样做一次。 (1.5 新增 ）jsonp类型: string在一个jsonp哀求中重写回调函数的名字。这个值用来替代在"callback=?"这种get或post哀求中url

20、参数里的"callback"部分，比如jsonp:&39;onjsonpload&39;会导致将"onjsonpload=?"传给服务器。在jquery 1.5，设置jsonp选项为false，阻挡了jquery从加入"?callback"字符串的url或试图用法"=?"转换。在这种状况下，你也应当明确设置jsonpcallback设置。例如, jsonp: false, jsonpcallback: "callbac

21、kname" jsonpcallback类型: string, function为jsonp哀求指定一个回调函数名。这个值将用来取代jquery自动生成的随机函数名。这主要用来让jquery生成一个独特的函数名，这样管理哀求更简单，也能便利地提供回调函数和错误处理。你也可以在想让扫瞄器缓存get哀求的时候，指定这个回调函数名。从jquery 1.5开头，你也可以用法一个函数作为该参数设置，在这种状况下，该函数的返回值就是jsonpcallback的结果。mimetype类型: string一个mime类型用来笼罩xhr的 mime类型。 (1.5 新增 ）password类型

22、: string用于响应http拜访认证哀求的密码processdata (默认: true)类型: boolean默认状况下，通过data选项传递进来的数据，假如是一个对象(技术上讲只要不是字符串)，都会处理转化成一个查询字符串，以协作默认内容类型 "application/x-www-form-urlencoded"。假如要发送 dom 树信息或其它不希翼转换的信息，请设置为 false。scriptcharset类型: string仅适用于当"script"传输用法时（例如，跨域的"jsonp&am

23、p;quot;或 datatype选项为"script" 和 "get"类型）。哀求中用法在script标签上设置charset 属性。通常只在本地和远程的内容编码不同时用法。statuscode (默认: )类型: plainobject一组数值的http代码和函数对象，当响应时调用了相应的代码。例如，假如响应状态是404，将触发以下警报：$.ajax(statuscode: 404: function() alert("page not found"););假如哀求胜利，状态代码对应

24、的函数作为回调的胜利相同的参数;假如在一个错误的结果，他们实行了相同的参数error回调。(1.5 新增 ）success类型: function( object data, string textstatus, jqxhr jqxhr )哀求胜利后的回调函数。这个函数传递3个参数：从服务器返回的数据，并按照datatype参数举行处理后的数据，一个描述状态的字符串;还有 jqxhr（在jquery 1.4.x前为xmlhttprequest） 对象 。在jquery 1.5， 胜利设置可以接受一个函数数组。每个函数将被依次调用。这是一个 ajax eventtimeout类型: number设置哀求超时时光（毫秒）。此设置将笼罩$.ajaxsetup() 里的全局设置。 超时周期开头于$.ajax 拜访胜利的那个时光点；假如几个其他哀求都在长进并且扫瞄器有没有可用的衔接，它有可能在被发送前就超时了。在 jquery 1.4.x 和前面的版本中, 假如哀求超时，xmlhttprequest对象是处于无效状态;拜访任何对象的成员可能会抛出一个异样。惟独在 fir