《锋利的jQuery》九、$.ajax()的方法

---

title: 《锋利的jQuery》九、$.ajax()的方法
date: 2017-08-22 21:25:20
tags: 锋利的jQuery

---

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