jquery ajax请求参数和回调函数
(一)常用参数
参数 | 类型 | 默认值 | 备注 |
---|---|---|---|
url | String | 当前页地址 | 发送请求的地址 |
type | String | “GET” | 请求方式 (“POST” 或 “GET”) |
data | String | 发送到服务器的数据。 | |
async | Boolean | true | 1. 默认设置下,所有请求均为异步请求。 2.如果需要发送同步请求,请将此选项设置为 false |
cache | Boolean | true | 1. dataType 为 script 和 jsonp 时默认为 false。 2. 设置为 false 将不缓存此页面。 |
contentType | String | “application/x-www-form-urlencoded” | 1. 发送信息至服务器时内容编码类型。 2.如果你明确地传递了一个 content-type 给 $.ajax() 那么它必定会发送给服务器(即使没有数据要发送)。 |
processData | Boolean | true | 是否处理通过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);
}
});
}
(三)其他参数
参数 | 类型 | 默认值 | 备注 |
---|---|---|---|
context | Object | 这个对象用于设置 Ajax 相关回调函数的上下文。 | |
dataType | String | 预期服务器返回的数据类型。 | |
global | Boolean | true | 是否触发全局 AJAX 事件 |
ifModified | Boolean | false | 仅在服务器数据改变时获取新数据。 |
jsonp | String | 在一个 jsonp 请求中重写回调函数的名字 | |
jsonpCallback | String | 为 jsonp 请求指定一个回调函数名。 | |
password | String | 用于响应 HTTP 访问认证请求的密码 | |
scriptCharset | String | 通常只在本地和远程的内容编码不同时使用。 | |
traditional | Boolean | 用传统的方式来序列化数据 | |
timeout | Number | 设置请求超时时间(毫秒) | |
username | String | 用于响应 HTTP 访问认证请求的用户名 |
(四)其他回调函数
回调函数 | 备注 |
---|---|
beforeSend(XHR) | 1. 发送请求前可修改 XMLHttpRequest 对象的函数,如添加自定义 HTTP 头。 2. XMLHttpRequest 对象是唯一的参数。这是一个 Ajax 事件。如果返回 false 可以取消本次 ajax 请求。 |
complete(XHR, TS) | 1.请求完成后回调函数 (请求成功或失败之后均调用)。 2.参数: XMLHttpRequest 对象和一个描述请求类型的字符串。3.这是一个 Ajax 事件。 |
dataFilter | 请求成功之后调用;返回新的数据传递给 success 回调函数。 |
complete | 1. 当请求完成之后调用这个函数,无论成功或失败。 2. 传入 XMLHttpRequest 对象,以及一个包含成功或错误代码的字符串。 |
(五)备注
回调函数:请求完成时执行的函数,格式为:function(response,status,xhr)
其中:
- response - 包含来自请求的结果数据
- status - 包含请求的状态(“success”, “notmodified”, “error”, “timeout” 或 “parsererror”)
- xhr - 包含 XMLHttpRequest 对象