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, textstatus, 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, textstatus, jqxhr ){
alert("返回数据:" + data);
} ,
error: function(jqxhr, textstatus, 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" );
以上就是ajax请求 $.ajaxsetup方法的使用的详细内容。