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


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的跨域请求

你可能感兴趣的:(《锋利的jQuery》九、$.ajax()的方法)