首页 > 代码库 > 弄一个ajax笔记方便查询-$.ajax()

弄一个ajax笔记方便查询-$.ajax()

$.ajax()是所有ajax方法中最底层的方法,所有其他方法都是基于$.ajax()方法的封装。
这个方法只有一个参数,传递一个各个功能键值对的对象。

$.ajax()方法对象参数表:

参数               类型                说明url               String             发送请求的地址type              String             请求方式:POST或GET,默认GETtimeout           Number             设置请求超时的时间(毫秒)data              Object或String     发送到服务器的数据,对象或键值对字符串dataType          String             返回的数据类型,比如html、xml、json等beforeSend        Function           发送请求前可修改XMLHttpRequest对象的函数complete          Function           请求完成后调用的回调函数seccess           Function           请求成功后调用的回调函数error             Function           请求失败时调用的回调函数global            Boolean            默认为true,表示是否触发全局Ajaxcache             Boolean            设置浏览器缓存响应,默认为true。如果dataType类型为script或jsonp则为false。content           DOM                指定某个元素为与这个请求相关的所有回调函数的上下文。contentType       String             指定请求内容的类型。默认为application/x-www-form-urlencoded。async             Boolean            是否异步处理。默认为true,false为同步处理processData       Boolean            默认为true,数据被处理为URL编码格式。如果为false,则阻止将传入的数据处理为URL编码的格式。dataFilter        Function           用来筛选响应数据的回调函数。ifModified        Boolean            默认为false,不进行头检测。如果为true,进行头检测,当相应内容与上次请求改变时,请求被认为是成功的。jsonp             String             指定一个查询参数名称来覆盖默认的jsonp回调参数名callback。username          String             在HTTP认证请求中使用的用户名password          String             在HTTP认证请求中使用的密码scriptCharset     String             当远程和本地内容使用不同的字符集时,用来设置script和jsonp请求所使用的字符集。xhr               Function           用来提供XHR实例自定义实现的回调函数traditional       Boolean            默认为false,不使用传统风格的参数序列化。如为true,则使用。
$(‘.ajax_btn‘).on(‘click‘,function(){    $.ajax({        type:"GET",        url:"ajax.php",        data:{            url:"snail",        },        success:function(response,status,xhr){            console.log(response);        }    })});

注意:对于data属性,如果是GET模式,可以使用三种之前说所的三种形式。如果是POST模式可以使用之前的两种形式。

一.加载请求在Ajax异步发送请求时,遇到网速较慢的情况,就会出现请求时间较长的问题。而超过一定时间的请求,用户就会变得不再耐烦而关闭页面。而如果在请求期间能给用户一些提示,比如:正在努力加载中...,那么相同的请求时间会让用户体验更加的好一些。
Query提供了两个全局事件,.ajaxStart()和.ajaxStop()。这两个全局事件,只要用户触发了Ajax,请求开始时(未完成其他请求)激活.ajaxStart(),请求结束时(所有请求都结束了)激活.ajaxStop()。
$(‘.ajax_load‘).ajaxStart(function(){    $(this).show();}).ajaxStop(function(){    $(this).hide();});

注意:以上代码在jQuery1.8及以后的版本不在有效,需要使用jquery-migrate向下兼容才能运行。新版本中,必须绑定在document元素上。

$(document).ajaxStart(function(){    $(‘.ajax_load‘).show();}).ajaxStop(function(){    $(‘.ajax_load‘).hide();});
// 请求时间过长,导致页面呈现假死状态,所以可以设置超时$.ajax({    timeout:2000,});
// 如果某个ajax不想触发全局事件,可以设置取消;比如取消触发.ajaxStart()和.ajaxStop()全局事件:$.ajax({    global:false,});
二.错误处理Ajax异步提交时,不可能所有情况都是成功完成的,也有因为代码异步文件错误、网络错误导致提交失败的。这时,我们应该把错误报告出来,提醒用户重新提交或提示开发者进行修补。在之前高层封装中是没有回调错误处理的,比如$.get()、$.post()和.load()。所以,早期的方法通过全局.ajaxError()事件方法来返回错误信息。而在jQuery1.5之后,可以通过连缀处理使用局部.error()方法即可。而对于$.ajax()方法,不但可以用这两种方法,还有自己的属性方法error:function(){}
$(‘.ajax_btn‘).on(‘click‘,function(){    $.ajax({        type:"GET",        url:"ajax.php",        data:{            url:"snail",        },        success:function(response,status,xhr){            console.log(response);        },        error:function(xhr,errorText,errorStatus){            console.log(xhr);            console.log(errorText);            console.log(errorStatus);        }    })});
// $.post()使用连缀.error()方法提示错误,连缀方法将被.fail()取代$.post(‘ajax.php‘).error(function(xhr,status,info){    console.log(xhr.status+‘:‘+xhr.statusText);    console.log(status+‘:‘+info);});
// $.post()使用全局.ajaxError()事件提示错误$(document).ajaxError(function(event,xhr,settings,infoError){    alert(xhr.status+‘:‘+xhr.statusText);    alert(settings+‘:‘+info);});
三.请求全局事件jQuery对于Ajax操作提供了很多全局事件方法,.ajaxStart()、.ajaxStop()、.ajaxError()等事件方法。他们都属于请求时触发的全局事件,除了这些,还有一些其他全局事件:.ajaxSend(),没有对应的局部方法,只有属性beforeSend,请求发送之前要绑定的函数。.ajaxComplete(),对应一个局部方法:.complete(),请求完成后注册一个回调函数。.ajaxSuccess(),对应一个局部方法:.success(),请求成功完成时执行。注意:全局事件方法是所有Ajax请求都会触发到,并且只能绑定在document上。而局部方法,则针对某个Ajax。对于一些全局事件方法的参数,大部分为对象,而这些对象有哪些属性或方法能调用,可以通过遍历方法得到。
// 遍历settings对象的属性$(document).ajaxSuccess(function(event,xhr,settings){    for(var i in settings){        console.log(i);    }});
// $.post()请求完成的局部方法.complete()$.post().complete(function(xhr,status){    console.log("完成!");})
// $.post()请求完成的全局方法.ajaxComplete()$(document).ajaxComplete(function(event,xhr,setting){    console.log("完成!");})
// $.ajax()方法,可以直接通过属性设置即可。$.ajax({    type:"POST",    url:"ajax.php",    success:function(data,status,xhr){},    complete:function(xhr,status){},    beforeSend:function(xhr,settints){}})

注意:在jQuery1.5版本以后,使用.success()、.error()和.complete()连缀的方法,可以用.done()、.fail()和.always()取代。

四.JSON和JSONP如果在同一个域下,$.ajax()方法只要设置dataType属性即可加载JSON文件。而在非同域下,可以使用JSONP,但也是有条件的。如果想跨域操作文件的话,我们就必须使用JSONP。JSONP(JSON with Padding)是一个非官方的协议,它允许在服务器端集成Script tags返回至客户端,通过javascriptcallback的形式实现跨域访问(这仅仅是JSONP简单的实现形式)。
$.ajax({    type:"GET",    dataType:"jsonp",    success:function(data,status,xhr){}})
五.jqXHR对象在之前,我们使用了局部方法:.success()、.complete()和.error()。这三个局部方法并不是XMLHttpRequest对象调用的,而是$.ajax()之类的全局方法返回的对象调用的。这个对象,就是jqXHR对象,它是原生对象XHR的一个超集。注意:如果使用jqXHR对象的话,那么建议用.done()、.always()和.fail()代 替.success()、.complete()和.error()。以为在未来版本中,很可能将这三种方法废弃取消。使用jqXHR的连缀方式比$.ajax()的属性方式有三大好处:1.可连缀操作,可读性大大提高;2.可以多次执行同一个回调函数;3.为多个操作指定回调函数;

 

弄一个ajax笔记方便查询-$.ajax()