所有options均可选,下面简要说明每个option
- async:默认为true,即请求为异步请求,这也是ajax存在的意义。但同时也可以将这个参数设置为false,实现同步请求。(同步请求会锁定浏览器,直到这个请求结束后才可以执行其他操作)
- bforeSend(XHR):这个方法是用来在发送请求前修改XMLHttpRequest对象的,若修改失败返回false,则取消此次ajax请求;
- cache:默认为true,设置为false即不缓存。(当datatype为script或jasonp时默认为fasle)
- complete(jqXHR,textStatus):请求完成后的回调函数,无论成功与否。textStatus为一个描述请求类型的字符串,它可以有以下值success,notmodified,error,timeout,abort,parsererror。
- contents:jQuery1.5添加。一个字符串或常规表达式的map,用来确定用何种方式处理jQuery的response。
- contentType:它是发送到服务器的额数据的内容编码类型,它的默认值是"appliction/x-www-form-urlencoded"。传递的服务器的数据通常以UTF-8编码。
- context:用来设置ajax回调函数的上下文。让回调函数中的this指向这个对象。
- converters:jQuery1.5添加。一组数据类型到数据类型的转换。每一个转换值都是一个返回了response转换后的值的方法。
- crossDomain:false表示同一域请求,true表示跨域请求。它可以使服务器端重定向到另外一个域。
- data:发送到服务器的数据。必须为key/value格式。且自动转换为query string,get请求会将字符串附加在url后。
- dataFilter(data,type):将ajax的返回值进行预处理的函数,data为返回值,teype为传递的datatype参数。
- dataType:预期服务器返回的数据类型。若没指定,则自动根据http包中的mime信息来判断。可用值为xml,html,script,json,jsonp,text。
- error(jqXHR,textStatus,errorThrown):当请求失败时调用这个方法。textStatus为错误信息,可用值为error,timeout,abort,parsererror。errorThrown为可选的要捕获的异常对象。
- global:默认为true,触发全局ajax事件。设置为false可以用来不触发。可以用来控制不同的ajax事件。
- headers:jQuery1.5添加。一个用于一起进行请求的额外的key/value对的map。这项需要在beforeSend方法被调用前设置,因为headers中的任意值都有肯那个在beforeSend方法中被覆盖。
- ifModified:默认为false,仅在服务器数据改变时获取数据,使用http包中的Last-Modified头信息判断。
- isLocal:jQuery1.5.1添加。允许将当前环境识别为local,jquery默认是不会识别的。file,*-extension 和widget协议可以被识别为local。如果isLocal需要被修改,推荐使用$.ajaxSetup()方法。
- jsonp:重启jsonp请求中的回调函数名。这个值用来代替在“callback=?”这种请求中url参数里的callback部分。
- jsonpCallback:为jsonp请求指定一个回调函数名。jquery会自动生成随机函数名