//事件触发顺序ajaxStart,ajaxSend,ajaxSuccess或ajaxError,ajaxComplete,ajaxStop $(document).ajaxStart(function (event) { /* * 每一个ajax即将发送的时候触发该事件,只有一个事件对象参数 */ console.log(‘ajaxStart‘); }) $(document).ajaxSend(function (event,xhr,opts,err) { /* * 每一个ajax即将发送的时候触发该事件 * 此方法接受四个参数,分别是事件对象,XHR对象,和发起ajax请求的配置对象,错误信息 */ if(opts.type == ‘get‘){ xhr.abort(); } }) $(document).ajaxSuccess(function (event,opts) { /* * 此方法接受三个参数,分别是事件对象,XHR对象,和发起ajax请求的配置对象 * 每一个ajax请求成功都会触发该事件 * 配置对象中的success回调会先执行,然后再执行这个事件 */ console.log(JSON.parse(xhr.responseText)) }) $(document).ajaxError(function (event,err) { /* * 此方法接受四个参数,分别是事件对象,XHR对象,和发起ajax请求的配置对象,错误信息 * 每一个ajax请求失败都会触发该事件 * 配置对象中的error回调会先执行,然后再执行这个事件 * 如果是客户端错误导致请求失败,err的值有可能是timeout,abort,或者是抛出错误异常对象 */ console.log(err) }) $(document).ajaxComplete(function (event,opts) { /* * 此方法接受三个参数,分别是事件对象,XHR对象,和发起ajax请求的配置对象 * 每一个ajax请求完成都会触发该事件,不管请求的结果如何 * 配置对象中的complete回调会先执行,然后再执行这个事件 */ }) $(document).ajaxStop(function (event) { /* * 此方法只接受一个事件对象参数,此事件只触发一次 * 当所有ajax请求完成的时候调用一次,不管ajax请求的状态是失败还是成功或是被取消 */ })
?注意:ajaxStart和ajaxSend事件必须放在ajax请求代码之前,不然不会触发
jquery中的ajax方法参数总是记不住,这里记录一下。
?
1.url:?
要求为String类型的参数,(默认为当前页地址)发送请求的地址。
2.type:?
要求为String类型的参数,请求方式(post或get)默认为get。注意其他http请求方法,例如put和delete也可以使用,但仅部分浏览器支持。
3.timeout:?
要求为Number类型的参数,设置请求超时时间(毫秒)。此设置将覆盖$.ajaxSetup()方法的全局设置。
4.async:?
要求为Boolean类型的参数,默认设置为true,所有请求均为异步请求。如果需要发送同步请求,请将此选项设置为false。注意,同步请求将锁住浏览器,用户其他操作必须等待请求完成才可以执行。
5.cache:?
要求为Boolean类型的参数,默认为true(当dataType为script时,默认为false),设置为false将不会从浏览器缓存中加载请求信息。
6.data:?
要求为Object或String类型的参数,发送到服务器的数据。如果已经不是字符串,将自动转换为字符串格式。get请求中将附加在url后。防止这种自动转换,可以查看 processData选项。对象必须为key/value格式,例如{foo1:"bar1",foo2:"bar2"}转换为&foo1=bar1&foo2=bar2。如果是数组,JQuery将自动为不同值对应同一个名称。例如{foo:["bar1","bar2"]}转换为&foo=bar1&foo=bar2。
7.dataType:?
要求为String类型的参数,预期服务器返回的数据类型。如果不指定,JQuery将自动根据http包mime信息返回responseXML或responseText,并作为回调函数参数传递。可用的类型如下:
xml:返回XML文档,可用JQuery处理。
html:返回纯文本HTML信息;包含的script标签会在插入DOM时执行。
script:返回纯文本JavaScript代码。不会自动缓存结果。除非设置了cache参数。注意在远程请求时(不在同一个域下),所有post请求都将转为get请求。
json:返回JSON数据。
jsonp:JSONP格式。使用SONP形式调用函数时,例如myurl?callback=?,JQuery将自动替换后一个“?”为正确的函数名,以执行回调函数。
text:返回纯文本字符串。
8.beforeSend:
要求为Function类型的参数,发送请求前可以修改XMLHttpRequest对象的函数,例如添加自定义HTTP头。在beforeSend中如果返回false可以取消本次ajax请求。XMLHttpRequest对象是惟一的参数。
??????????? function(XMLHttpRequest){
?????????????? this;?? //调用本次ajax请求时传递的options参数
??????????? }
9.complete:
要求为Function类型的参数,请求完成后调用的回调函数(请求成功或失败时均调用)。参数:XMLHttpRequest对象和一个描述成功请求类型的字符串。
????????? function(XMLHttpRequest,textStatus){
???????????? this;??? //调用本次ajax请求时传递的options参数
????????? }
10.success:要求为Function类型的参数,请求成功后调用的回调函数,有两个参数。
???????? (1)由服务器返回,并根据dataType参数进行处理后的数据。
???????? (2)描述状态的字符串。
???????? function(data,textStatus){
??????????? //data可能是xmlDoc、jsonObj、html、text等等
??????????? this;? //调用本次ajax请求时传递的options参数
???????? }
11.error:
要求为Function类型的参数,请求失败时被调用的函数。该函数有3个参数,即XMLHttpRequest对象、错误信息、捕获的错误对象(可选)。ajax事件函数如下:
?????? function(XMLHttpRequest,textStatus,errorThrown){
????????? //通常情况下textStatus和errorThrown只有其中一个包含信息
????????? this;?? //调用本次ajax请求时传递的options参数
?????? }
12.contentType:
要求为String类型的参数,当发送信息至服务器时,内容编码类型默认为"application/x-www-form-urlencoded"。该默认值适合大多数应用场合。
13.dataFilter:
要求为Function类型的参数,给Ajax返回的原始数据进行预处理的函数。提供data和type两个参数。data是Ajax返回的原始数据,type是调用jQuery.ajax时提供的dataType参数。函数返回的值将由jQuery进一步处理。
??????????? function(data,type){
??????????????? //返回处理后的数据
??????????????? return data;
??????????? }
14.dataFilter:
要求为Function类型的参数,给Ajax返回的原始数据进行预处理的函数。提供data和type两个参数。data是Ajax返回的原始数据,type是调用jQuery.ajax时提供的dataType参数。函数返回的值将由jQuery进一步处理。
??????????? function(data,type){
??????????????? //返回处理后的数据
??????????????? return data;
??????????? }
15.global:
要求为Boolean类型的参数,默认为true。表示是否触发全局ajax事件。设置为false将不会触发全局ajax事件,ajaxStart或ajaxStop可用于控制各种ajax事件。
16.ifModified:
要求为Boolean类型的参数,默认为false。仅在服务器数据改变时获取新数据。服务器数据改变判断的依据是Last-Modified头信息。默认值是false,即忽略头信息。
17.jsonp:
要求为String类型的参数,在一个jsonp请求中重写回调函数的名字。该值用来替代在"callback=?"这种GET或POST请求中URL参数里的"callback"部分,例如{jsonp:‘onJsonPLoad‘}会导致将"onJsonPLoad=?"传给服务器。
18.username:
要求为String类型的参数,用于响应HTTP访问认证请求的用户名。
19.password:
要求为String类型的参数,用于响应HTTP访问认证请求的密码。
20.processData:
要求为Boolean类型的参数,默认为true。默认情况下,发送的数据将被转换为对象(从技术角度来讲并非字符串)以配合默认内容类型"application/x-www-form-urlencoded"。如果要发送DOM树信息或者其他不希望转换的信息,请设置为false。
21.scriptCharset:
要求为String类型的参数,只有当请求时dataType为"jsonp"或者"script",并且type是GET时才会用于强制修改字符集(charset)。通常在本地和远程的内容编码不同时使用。
案例代码:
$(function(){ $(‘#send‘).click(function(){ $.ajax({ type: "GET",url: "test.json",data: {username:$("#username").val(),content:$("#content").val()},dataType: "json",success: function(data){ $(‘#resText‘).empty(); //清空resText里面的所有内容 var html = ‘‘; $.each(data,function(commentIndex,comment){ html += ‘<div class="comment"><h6>‘ + comment[‘username‘] + ‘:</h6><p class="para"‘ + comment[‘content‘] + ‘</p></div>‘; }); $(‘#resText‘).html(html); } }); }); });
?
22.顺便说一下$.each()函数:
$.each()函数不同于JQuery对象的each()方法,它是一个全局函数,不操作JQuery对象,而是以一个数组或者对象作为第1个参数,以一个回调函数作为第2个参数。回调函数拥有两个参数:第1个为对象的成员或数组的索引,第2个为对应变量或内容。
?
jQuery.ajaxSetup() 函数详解
可以参考这篇:http://www.365mini.com/page/jquery_ajaxsetup.htm
链接2:http://www.voidcn.com/article/p-rjjkiink-bao.html
不过要注意:如果用户在自己的ajax定义了和全局ajaxSetup一样的属性,则用户定义的属性会覆盖全局默认的属性。如用户自己定义了属性error,ajaxSetup也定义了error,出现error时,会走用户自定义的error,不会走ajaxSetup的error。
如果你想写一遍ajaxSetup,让其他页面都支持这个功能,可以这样做:
写一个js,让替他页面引入这个js就行了。如写ajaxSetup.js,ajaxSetup.js里内容
?
- $(function(){??
- ????$.ajaxSetup(?{??
- ????????url:?"/index.html"?,?//?默认URL??
- ????????aysnc:?false?,?//?默认同步加载??
- ????????type:?"POST"?,?//?默认使用POST方式??
- ????????headers:?{?//?默认添加请求头??
- ????????????"Author":?"CodePlayer"?,??
- ????????????"Powered-By":?"CodePlayer"??
- ????????}?,??
- ????????error:?function(jqXHR,?textStatus,?errorMsg){?//?出错时默认的处理函数??
- ????????????//?jqXHR?是经过jQuery封装的XMLHttpRequest对象??
- ????????????//?textStatus?可能为:?null、"timeout"、"error"、"abort"或"parsererror"??
- ????????????//?errorMsg?可能为:?"Not?Found"、"Internal?Server?Error"等??
- ??
- ????????????//?提示形如:发送AJAX请求到"/index.html"时出错[404]:Not?Found??
- ?????????????
- ????????????if?(jqXHR.status==500)?{??
- ?????????????????alert(?‘出错[‘?+?jqXHR.status?+?‘]:‘?+?errorMsg+‘:::‘+jqXHR.responseText?);????
- ????????????}??
- ????????????if?(jqXHR.status==404)?{??
- ????????????????alert(?‘出错[‘?+?jqXHR.status?+?‘]:‘?+?errorMsg+‘:::‘+jqXHR.responseText?);????
- ????????????}??
- ??????????????
- ????????}??
- ????}?);??
- });??
jQuery.ajaxSetup()
函数用于设置AJAX的全局默认设置。
该函数用于更改jQuery中AJAX请求的默认设置选项。之后执行的所有AJAX请求,如果对应的选项参数没有设置,将使用更改后的默认设置。
该函数属于全局jQuery
对象。
语法
jQuery?1.1 新增该静态函数。
?
- jQuery.ajaxSetup(?settings?)??
参数
参数 | 描述 |
---|---|
settings | Object类型一个对象,其中的每个属性表示需要更改默认设置的选项,属性值表示更改后的默认值。 |
关于settings
参数可以识别的属性,请参考jQuery.ajax()
中的settings参数说明。其中的所有选项参数都是可选设置的。
返回值
jQuery.ajaxSetup()
函数没有返回值,或者说其返回值为undefined
。
示例&说明
以下是与jQuery.ajaxSetup()
函数相关的jQuery示例代码,以演示jQuery.ajaxSetup()
函数的具体用法:
?
- //设置AJAX的全局默认选项??
- $.ajaxSetup(?{??
- ????url:?"/index.html"?,?//?默认URL??
- ????aysnc:?false?,?//?默认同步加载??
- ????type:?"POST"?,?//?默认使用POST方式??
- ????headers:?{?//?默认添加请求头??
- ????????"Author":?"CodePlayer"?,??
- ????????"Powered-By":?"CodePlayer"??
- ????}?,??
- ????error:?function(jqXHR,?errorMsg){?//?出错时默认的处理函数??
- ????????//?jqXHR?是经过jQuery封装的XMLHttpRequest对象??
- ????????//?textStatus?可能为:?null、"timeout"、"error"、"abort"或"parsererror"??
- ????????//?errorMsg?可能为:?"Not?Found"、"Internal?Server?Error"等??
- ??
- ????????//?提示形如:发送AJAX请求到"/index.html"时出错[404]:Not?Found??
- ????????alert(?‘发送AJAX请求到"‘?+?this.url?+?‘"时出错[‘?+?jqXHR.status?+?‘]:‘?+?errorMsg?);??????????
- ????}??
- }?);??
- ??
- ??
- //?未设置任何参数,但url、async、type、headers、error等参数的默认值均已被$.ajaxSetup()更改(如上)??
- $.ajax(?);??
- ??
- ??
- //?设置了url、type、success、error,就使用自己设置的参数值??
- //?但async、headers等参数的默认值已被$.ajaxSetup()更改??
- $.ajax(?{??
- ????url:?"myurl.php?action=list"?,??
- ????type:?"GET"?,??
- ????success:?function(?data,?jqXHR?){??
- ????????alert("返回数据:"?+?data);??
- ????}?,??
- ????error:?function(jqXHR,?errorMsg){??
- ????????alert("自己的error!");??????????
- ????}??
- });??
- ??
- //?上述$.ajaxSetup()的默认设置对$.get()、$.post()、load()、$.getJSON()、$.getScript()等AJAX函数也生效??
- //?因为这些函数也是在内部调用$.ajax()函数来实现的,只不过它们在内部都设置了一些参数??
- ??
- ??
- //?$.get()在内部调用$.ajax()时已设置type为"GET",因此仍然使用GET方式。??
- //?但url、async、headers、error等参数的默认值已被$.ajaxSetup()更改??
- $.get(?);??
- ??
- ??
- //?$.post()在内部调用$.ajax()时已设置type为"POST",因此仍然使用POST方式。??
- //?url也被设置为"user/action.php?method=addUser"??
- //?但async、headers、error等参数的默认值已被$.ajaxSetup()更改??
- $.post(?"user/action.php?method=addUser"?);??