title: 《锋利的jQuery》九、$.ajax()的方法
date: 2017-08-22 21:25:20
tags: 锋利的jQuery
| 参数名称 | 类型 | 说明 |
|---|---|---|
| accepts | Map | 内容类型发送请求头，告诉服务器什么样的响应会接受返回。如果accepts设置需要修改，推荐在$.ajaxSetup()方法中做一次。 |
| async | Boolean | 默认设置下（默认为true），所有请求均为异步请求。如果需要发送同步请求，要将此选项设置为false，跨域不支持同步操作。 |
| beforeSend | Function | 发送请求前可修改XMLHttpRequest对象的函数，返回false可取消本次请求，function(XMLHttpRequest){ this是请求时传递的option参数 }
|
| cache | Boolean | 默认true，当跨域时默认为false，false时将不会从浏览器缓存中加载请求信息 |
| complete | Function | 请求完成后的回调函数，function(XMLHttpRequest, textStatus){ this是请求时传递的option参数 }
|
| contents | Map | 以"{ 字符串: 正则表达式 }"配对的对象，用来确定jQuery将如何解析响应，给定其内容类型。 |
| contentType | String | 当发送信息至服务器时，内容编码类型默认为"application/x-www-form-urlencoded" |
| context | Object | 这个对象用于设置Ajax相关回调函数的上下文，也就是回调函数this的设置，默认是传递的option参数 |
| converters | Map | 一个数据类型对数据类型转换器的对象。每个转换器的值是一个函数，返回相应的转化值。 |
| crossDomain | 同域请求为false，跨域请求为true，如果要通过JSONP请求同域应该设置为true。 | |
| data | Object或String | 发送到服务器的数据 |
| dataFilter | Function | 给Ajax返回的原始数据进行预处理的函数。function(data, type){ data是Ajax返回的原始数据，type是调用$.ajax时提供的dataType参数，最后需要return data }
|
| dataType | String | 预期服务器返回的数据类型。如果不指定将根据MIME信息返回，可用类型：xml、html、script、json、jsonp、text |
| error | Function | 请求失败时被调用的函数 function(XMLHttpRequest, textStatus, errorThrown){ this是请求时传递的option参数 }
|
| global | Boolean | 是否触发全局Ajax事件，默认为true。 |
| Headers | Map | 一个额外的"{ 键: 值 }"对映射到请求一起发送，此设置被设置之前beforeSend函数被调用，因此，消息头中的值设置可以在覆盖beforeSend函数范围内的任何设置 |
| ifModified | Boolean | 默认:false 仅在服务器数据改变时获取新数据，使用HTTP包Last-Modified头信息判断，也会检查服务器指定的'etag'来确定数据没有被修改过 |
| isLocal | Boolean | 允许当前环境被认定为"本地"(比如系统文件)，即使jQuery默认情况下不会承认它。以下协议目前目前公认为本地：file、*-extension、widget。如果要修改isLocal，建议在$.ajaxSetup()中做 |
| jsonp | String | 在一个jsonp请求中重写回调函数的名字，这个值用来替代在"callback=?"这种GET货POST请求中URL参数里的"callback"部分，jsonp可是设置为false，为了阻止在URL中加入callback参数，但仍然要设置jsonpCallback参数。 |
| jsonpCallback | String，Function | 为jsonp请求指定一个回调函数名，这个值将用来取代jQuery自动生成的随机函数名。 |
| mimeType | String | 一个mime类型用来覆盖XHR的MIME的类型 |
| password | String | 用于响应HTTP访问认证请求的密码 |
| processData | Boolean | 默认为true，默认情况下，发送的数据将被转换为对象(实际上是非字符串)以配合默认内容类型"application/x-www-form-urlencoded"。如果要发送DOM树信息或者其他不希望转换的信息，要设置为false。 |
| scriptCharset | String | 只有当请求dataType为"jsonp"或者"script"，并且type时GET时才会用于强制修改字符集(charset)。通常在本地和远程的内容编码不同时使用。 |
| statusCode | Map | 一组数值的HTTP代码和函数对象，当响应时调用了相应的代码，例如，如果响应状态是404，将触发以下报警：statusCode: { 404: function(){ alert('page not found') } }
|
| success | Function | 请求成功后的回调函数，三个参数，返回的数据、描述状态的字符串、jqXHR对象 |
| timeout | Number | 设置请求超时时间(毫秒)，此设置将覆盖$.ajaxSetup方法的全局设置。 |
| traditional | Boolean | 如果想要用传统的方法来序列化数据，那么就设置为true，可以参考jQuery.param方法。 |
| Type | String | 请求方式(POST或GET)，默认为GET，跨域只能是GET方式。 |
| url | String | 发送请求的地址，默认为当前页面 |
| username | String | 用于响应HTTP访问认证请求的用户名 |
| xhr | Function | 回调创建XMLHttpRequest对象，当可用时默认为ActiveObject（IE）中，否则为XMLHttpRequest |
| xhrFields | Map | 一对"文件名-文件值"在本机设置XHR对象。例如，如果需要德华，可以用它来设置withCredentials为true的跨域请求 |
