jQuery ajax参数含义

全部options都可选,下面简要说明每一个optionhtml

1.async

默认为true,即请求为异步请求,这也是ajax存在的意义。但同时也能够将这个参数设置为false,实现同步请求。(同步请求会锁定浏览器,直到这个请求结束后才能够执行其余操做)jquery

2.bforeSend(XHR)

这个方法是用来在发送请求前修改XMLHttpRequest对象的,若修改失败返回false,则取消这次ajax请求;ajax

3.cache

默认为true,设置为false即不缓存。(当datatype为script或jasonp时默认为fasle)json

4.complete(jqXHR,textStatus)

请求完成后的回调函数,不管成功与否。textStatus为一个描述请求类型的字符串,它能够有如下值success,notmodified,error,timeout,abort,parsererror。跨域

5.contents

jQuery1.5添加。一个字符串或常规表达式的map,用来肯定用何种方式处理jQuery的response。浏览器

6.contentType

它是发送到服务器的额数据的内容编码类型,它的默认值是"appliction/x-www-form-urlencoded"。传递的服务器的数据一般以UTF-8编码。缓存

7.context

用来设置ajax回调函数的上下文。让回调函数中的this指向这个对象。服务器

8.converters

jQuery1.5添加。一组数据类型到数据类型的转换。每个转换值都是一个返回了response转换后的值的方法。app

9.crossDomain

false表示同一域请求,true表示跨域请求。它可使服务器端重定向到另一个域。异步

10.data

发送到服务器的数据。必须为key/value格式。且自动转换为query string,get请求会将字符串附加在url后。

11.dataFilter(data,type)

将ajax的返回值进行预处理的函数,data为返回值,teype为传递的datatype参数。

12.dataType

预期服务器返回的数据类型。若没指定,则自动根据http包中的mime信息来判断。可用值为xml,html,script,json,jsonp,text。

13.error(jqXHR,textStatus,errorThrown)

当请求失败时调用这个方法。textStatus为错误信息,可用值为error,timeout,abort,parsererror。errorThrown为可选的要捕获的异常对象。

14.global

默认为true,触发全局ajax事件。设置为false能够用来不触发。能够用来控制不一样的ajax事件。

15.headers

jQuery1.5添加。一个用于一块儿进行请求的额外的key/value对的map。这项须要在beforeSend方法被调用前设置,由于headers中的任意值都有肯那个在beforeSend方法中被覆盖。

16.ifModified

默认为false,仅在服务器数据改变时获取数据,使用http包中的Last-Modified头信息判断。

17.isLocal

jQuery1.5.1添加。容许将当前环境识别为local,jquery默认是不会识别的。file,*-extension 和widget协议能够被识别为local。若是isLocal须要被修改,推荐使用$.ajaxSetup()方法。

18.jsonp

重启jsonp请求中的回调函数名。这个值用来代替在“callback=?”这种请求中url参数里的callback部分。

19.jsonpCallback

为jsonp请求指定一个回调函数名。jquery会自动生成随机函数名,用这个值能够修改此名。

20.mimetype

jQuery1.5.1添加。能够用来覆盖XHR中的mimetype。

21.password

用于响应http访问认证请求的密码。

22.processData

默认为true。能够将data传递的数据类型进行修改用来匹配contenttype的类型。false则不修改。

23.scriptCharset

只有当请求为jsonp或script,而且type为get时才会用于强制修改charset。

24.statusCode

jQuery1.5添加。用来定义http的返回码对应的处理函数。下面的例子定义了返回404后的处理方法。

25.success(data,textStatus,jqXHR)

请求成功后的回调函数。参数由服务器返回,并会根据datatype参数进行参数处理。

26.timeout

设置请求超时时间,毫秒为单位。此设置会覆盖全局设置,即全部ajax请求共享同一个超时时间。

27.traditional

设置为true,用传统的方式来序列化数据。

28.type

请求方式,get或post或put或delete。默认为get。put和delte不是获得全部的浏览器支持。

29.url

发送请求的地址。为空表示当前页。

30.username

用于响应http访问认证请求的用户名。同password配对。

31.xhr

默认在ie下是ActiveXObject而其余浏览器是XMLHttpRequest。用于重写或提供一个加强的XMLHttpRequest对象。

32.xhrFields

jQuery1.5.1添加。它能够添加到原生xhr对象上的key/value对。举个例子,你能够经过它来设置跨域的withCredentials为true。

在jQuery1.5中,withCredentials这个属性不在原生的xhr中,因此这个请求会被忽略到。若要测试这个例子,须要使用jQuery1.5.1。

相关文章
相关标签/搜索