目录
在项目中正确使用 jQuery 的 AJAX 异步请求,需要兼顾代码规范性、错误处理、性能优化和用户体验。以下是一套完整的实践指南,涵盖从基础配置到高级技巧的核心要点:
一、基础规范:统一配置与封装
1. 全局配置:减少重复代码
通过 $.ajaxSetup()
设置全局默认参数(如基础 URL、超时时间、请求头等),避免在每个请求中重复配置:
javascript
// 全局 AJAX 配置(在项目入口处执行,如 main.js)
$.ajaxSetup({
// 基础 URL(拼接在所有请求地址前,适合多环境切换)
url: "/api",
// 默认超时时间(5秒)
timeout: 5000,
// 默认数据类型(优先 JSON)
dataType: "json",
// 请求头(如携带 Token 验证身份)
headers: {
"Authorization": "Bearer " + localStorage.getItem("token")
},
// 全局错误处理(避免每个请求重复写 error)
error: function(xhr) {
if (xhr.status === 401) {
// 未授权:跳转到登录页
window.location.href = "/login";
} else if (xhr.status === 500) {
alert("服务器错误,请稍后重试");
}
}
});
2. 封装请求函数:提高复用性
将常用请求(如 GET/POST)封装为独立函数,集中管理接口地址和参数处理,便于维护:
javascript
// 封装 API 请求模块(可单独放一个 api.js 文件)
const api = {
// 获取用户列表
getUserList: function(page = 1) {
return $.get("/users", { page, limit: 10 }); // 返回 jQuery deferred 对象
},
// 提交表单数据
submitForm: function(formData) {
return $.post("/submit", formData);
}
};
// 使用示例
api.getUserList(2).done(function(res) {
console.log("第2页用户:", res);
}).fail(function() {
console.log("获取失败");
});