文章目录
jquery ajax请求参数和回调函数(一)常用参数(二)常用回调函数(三)其他参数(四)其他回调函数(五)备注
jquery ajax请求参数和回调函数
(一)常用参数
参数类型默认值备注
urlString当前页地址发送请求的地址typeString“GET”请求方式 (“POST” 或 “GET”)dataString发送到服务器的数据。asyncBooleantrue1. 默认设置下,所有请求均为异步请求。 2.如果需要发送同步请求,请将此选项设置为 falsecacheBooleantrue1. dataType 为 script 和 jsonp 时默认为 false。 2. 设置为 false 将不缓存此页面。contentTypeString“application/x-www-form-urlencoded”1. 发送信息至服务器时内容编码类型。 2.如果你明确地传递了一个 content-type 给 $.ajax() 那么它必定会发送给服务器(即使没有数据要发送)。processDataBooleantrue是否处理通过data选项传递进来的数据
(二)常用回调函数
回调函数默认值备注
success请求成功后的回调函数。error自动判断 (xml 或 html)请求失败时调用此函数。
使用示例:
function upload() {
//请求参数
var data = {};
var send_data = JSON.stringify(data);
$.ajax({
//请求URL
url: 'http://127.0.0.1:5000/upload',
//请求方式,'POST'和'GET',这里是'POST'
type: 'POST',
//数据,json格式
data: send_data,
//将异步设置为false,将锁住浏览器,用户其它操作必须等待请求完成才可以执行
async: false,
//设置为 false 将不缓存此页面
cache: false,
//发送信息至服务器时内容编码类型。
contentType: "application/json;charset=UTF-8",
//请求成功后的回调函数。
success: function(returndata) {
alert(returndata);
},
//请求失败时调用此函数
error: function(error) {
alert(error);
}
});
}
(三)其他参数
参数类型默认值备注
contextObject这个对象用于设置 Ajax 相关回调函数的上下文。dataTypeString预期服务器返回的数据类型。globalBooleantrue是否触发全局 AJAX 事件ifModifiedBooleanfalse仅在服务器数据改变时获取新数据。jsonpString在一个 jsonp 请求中重写回调函数的名字jsonpCallbackString为 jsonp 请求指定一个回调函数名。passwordString用于响应 HTTP 访问认证请求的密码scriptCharsetString通常只在本地和远程的内容编码不同时使用。traditionalBoolean用传统的方式来序列化数据timeoutNumber设置请求超时时间(毫秒)usernameString用于响应 HTTP 访问认证请求的用户名
(四)其他回调函数
回调函数备注
beforeSend(XHR)1. 发送请求前可修改 XMLHttpRequest 对象的函数,如添加自定义 HTTP 头。2. XMLHttpRequest 对象是唯一的参数。这是一个 Ajax 事件。如果返回 false 可以取消本次 ajax 请求。complete(XHR, TS)1.请求完成后回调函数 (请求成功或失败之后均调用)。2.参数: XMLHttpRequest 对象和一个描述请求类型的字符串。3.这是一个 Ajax 事件。dataFilter请求成功之后调用;返回新的数据传递给 success 回调函数。complete1. 当请求完成之后调用这个函数,无论成功或失败。2. 传入 XMLHttpRequest 对象,以及一个包含成功或错误代码的字符串。
(五)备注
回调函数:请求完成时执行的函数,格式为:function(response,status,xhr)
其中:
response - 包含来自请求的结果数据status - 包含请求的状态(“success”, “notmodified”, “error”, “timeout” 或 “parsererror”)xhr - 包含 XMLHttpRequest 对象