手把手教你用JS写Ajax,超详细教程+代码实例!
时间:2025-06-22 11:09:10 404浏览 收藏
怎么入门文章编程?需要学习哪些知识点?这是新手们刚接触编程时常见的问题;下面golang学习网就来给大家整理分享一些知识点,希望能够给初学者一些帮助。本篇文章就来介绍《JS实现Ajax请求超详细教程(附代码示例)》,涉及到,有需要的可以收藏一下
AJAX 是一种无需刷新页面即可与服务器通信的技术,主要通过 JavaScript 实现。1. 使用 XMLHttpRequest 发送请求:创建对象、配置参数、发送请求、处理响应;2. 推荐使用更现代的 fetch API,基于 Promise,语法更简洁;3. 跨域问题可通过服务器端配置 CORS、JSONP、代理服务器等方式解决;4. 请求超时可设置 timeout 属性或使用 AbortController;5. 文件上传使用 FormData 对象;6. 可通过 abort 方法取消请求;7. 错误处理需结合状态码、网络错误、超时等综合处理;8. 实际开发中应根据兼容性选择 XMLHttpRequest 或 fetch。

AJAX,简单来说,就是让你的网页不用刷新就能和服务器“聊天”的技术。JS 是实现这个“聊天”的工具,而我们要聊的就是怎么用 JS 发送 AJAX 请求,以及一些实用技巧。

解决方案
发送 AJAX 请求的核心在于 XMLHttpRequest 对象(现在更推荐使用 fetch API,但为了兼容性,我们先说 XMLHttpRequest)。

基本步骤:
创建
XMLHttpRequest对象:
let xhr = new XMLHttpRequest();
配置请求:
xhr.open('GET', 'your_api_endpoint', true); // true 表示异步请求GET是请求方法,也可以是POST,PUT,DELETE等。your_api_endpoint是你服务器的 API 地址。true表示异步请求,false表示同步请求(不推荐同步,会阻塞页面)。
设置请求头(可选):
xhr.setRequestHeader('Content-Type', 'application/json'); // 如果发送 JSON 数据发送请求:
xhr.send(); // GET 请求不需要发送数据,POST 请求可以发送数据,例如:xhr.send(JSON.stringify(data));
处理响应:
xhr.onload = function() { if (xhr.status >= 200 && xhr.status < 300) { // 请求成功 console.log('Success:', xhr.responseText); // 处理返回的数据,例如 JSON.parse(xhr.responseText) } else { // 请求失败 console.log('Request failed. Returned status of ' + xhr.status); } }; xhr.onerror = function() { console.log('There was a network error.'); // 处理网络错误 };
完整示例:
function sendAjaxRequest(url, method, data, callback) {
let xhr = new XMLHttpRequest();
xhr.open(method, url, true);
xhr.onload = function() {
if (xhr.status >= 200 && xhr.status < 300) {
callback(null, xhr.responseText); // 成功回调
} else {
callback('Request failed. Returned status of ' + xhr.status, null); // 失败回调
}
};
xhr.onerror = function() {
callback('There was a network error.', null); // 网络错误回调
};
if (method === 'POST') {
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.send(JSON.stringify(data));
} else {
xhr.send();
}
}
// 使用示例:
sendAjaxRequest('/api/users', 'GET', null, function(error, response) {
if (error) {
console.error('Error:', error);
} else {
console.log('Response:', response);
// 处理用户数据
}
});
sendAjaxRequest('/api/users', 'POST', { name: 'John Doe', email: 'john.doe@example.com' }, function(error, response) {
if (error) {
console.error('Error:', error);
} else {
console.log('Response:', response);
// 处理服务器返回的响应
}
});如何处理 AJAX 请求中的跨域问题(CORS)?
CORS (Cross-Origin Resource Sharing) 是浏览器的一种安全机制,用于限制来自不同源的脚本访问资源。简单来说,如果你的网页和 API 服务器不在同一个域名下,就会遇到 CORS 问题。
解决方法:
服务器端配置: 这是最常见的解决方法。服务器需要在响应头中添加
Access-Control-Allow-Origin字段。Access-Control-Allow-Origin: *允许所有域名访问(不推荐在生产环境中使用)。Access-Control-Allow-Origin: https://your-domain.com只允许特定域名访问。
JSONP(仅限 GET 请求): JSONP 是一种古老的跨域技术,它利用
标签可以跨域加载资源的特性。 服务器返回的不是 JSON 数据,而是一段 JavaScript 代码,这段代码会调用预先定义好的回调函数。 虽然简单,但只支持 GET 请求,并且存在安全风险。代理服务器: 你的网页先向同域名的代理服务器发送请求,然后代理服务器再向目标 API 服务器发送请求。 这种方式可以绕过浏览器的 CORS 限制,但会增加服务器的负担。
CORS 插件(浏览器插件): 有一些浏览器插件可以禁用 CORS 检查,但这种方法只适用于开发环境。
最佳实践:
在生产环境中,强烈建议通过服务器端配置 CORS 来解决跨域问题。 确保只允许必要的域名访问,并设置合适的 Access-Control-Allow-Methods 和 Access-Control-Allow-Headers。
如何使用 fetch API 发送 AJAX 请求?
fetch API 是一个更现代、更强大的 AJAX 请求方式,它基于 Promise,使得代码更简洁易读。
基本用法:
fetch('/api/users', {
method: 'GET', // 默认是 GET
headers: {
'Content-Type': 'application/json'
},
// body: JSON.stringify(data) // 如果是 POST 请求,需要发送数据
})
.then(response => {
if (!response.ok) {
throw new Error('Network response was not ok ' + response.status);
}
return response.json(); // 将响应体解析为 JSON
})
.then(data => {
console.log('Success:', data);
// 处理数据
})
.catch(error => {
console.error('There has been a problem with your fetch operation:', error);
// 处理错误
});优点:
- 基于 Promise: 使得异步操作更易于管理和链式调用。
- 更简洁的语法: 减少了代码量,提高了可读性。
- 更强大的功能: 支持流式处理、拦截请求和响应等高级特性。
注意事项:
fetch API不会自动发送 cookies,如果需要发送 cookies,需要设置credentials: 'include'。fetch API默认不会处理 HTTP 错误状态码(例如 404, 500),需要手动检查response.ok。
如何处理 AJAX 请求的超时?
AJAX 请求超时是指在一定时间内,服务器没有返回响应,导致请求失败。 设置超时可以避免长时间等待,提高用户体验。
使用 XMLHttpRequest 设置超时:
let xhr = new XMLHttpRequest();
xhr.open('GET', '/api/users', true);
xhr.timeout = 5000; // 设置超时时间为 5 秒
xhr.onload = function() {
// ...
};
xhr.ontimeout = function() {
console.log('Request timed out.');
// 处理超时错误
};
xhr.send();使用 fetch API 设置超时:
fetch API 本身没有提供直接的超时设置,但可以通过 AbortController 来实现。
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), 5000); // 设置超时时间为 5 秒
fetch('/api/users', { signal: controller.signal })
.then(response => {
clearTimeout(timeoutId); // 清除超时定时器
// ...
})
.catch(error => {
clearTimeout(timeoutId); // 清除超时定时器
if (error.name === 'AbortError') {
console.log('Request timed out.');
// 处理超时错误
} else {
console.error('There has been a problem with your fetch operation:', error);
// 处理其他错误
}
});如何在 AJAX 请求中发送文件?
发送文件通常使用 FormData 对象。 FormData 对象可以模拟 HTML 表单,用于构建包含文件和其他数据的请求体。
示例:
<input type="file" id="fileInput">
<button onclick="uploadFile()">上传文件</button>
<script>
function uploadFile() {
let fileInput = document.getElementById('fileInput');
let file = fileInput.files[0];
if (!file) {
alert('Please select a file.');
return;
}
let formData = new FormData();
formData.append('file', file);
formData.append('description', 'This is a description of the file.'); // 可以添加其他字段
fetch('/api/upload', {
method: 'POST',
body: formData
})
.then(response => {
if (!response.ok) {
throw new Error('Network response was not ok ' + response.status);
}
return response.json();
})
.then(data => {
console.log('Success:', data);
// 处理上传成功后的响应
})
.catch(error => {
console.error('There has been a problem with your fetch operation:', error);
// 处理错误
});
}
</script>注意事项:
FormData对象会自动设置Content-Type为multipart/form-data,不需要手动设置。- 服务器端需要正确处理
multipart/form-data类型的请求。
如何取消正在进行的 AJAX 请求?
有时候,我们需要取消正在进行的 AJAX 请求,例如用户切换了页面或者输入了新的搜索条件。
使用 XMLHttpRequest 取消请求:
let xhr = new XMLHttpRequest();
xhr.open('GET', '/api/users', true);
xhr.onload = function() {
// ...
};
xhr.onerror = function() {
// ...
};
xhr.send();
// 取消请求:
xhr.abort();使用 fetch API 取消请求:
与设置超时类似,也需要使用 AbortController。
const controller = new AbortController();
fetch('/api/users', { signal: controller.signal })
.then(response => {
// ...
})
.catch(error => {
if (error.name === 'AbortError') {
console.log('Request aborted.');
// 处理请求取消
} else {
// ...
}
});
// 取消请求:
controller.abort();如何处理 AJAX 请求中的错误?
良好的错误处理是 AJAX 应用的关键。 我们需要考虑到各种可能出现的错误,例如网络错误、服务器错误、超时等。
常见的错误处理方法:
- 检查 HTTP 状态码:
XMLHttpRequest的status属性和fetch API的response.ok属性可以用来判断请求是否成功。 - 处理网络错误:
XMLHttpRequest的onerror事件和fetch API的catch方法可以用来捕获网络错误。 - 设置超时: 避免长时间等待,提高用户体验。
- 显示友好的错误信息: 不要直接将错误信息显示给用户,而是显示更友好的提示。
- 记录错误日志: 将错误信息记录到服务器端,方便调试和分析。
示例:
fetch('/api/users')
.then(response => {
if (!response.ok) {
console.error('HTTP error, status = ' + response.status);
throw new Error('HTTP error, status = ' + response.status); //抛出错误,让catch捕获
}
return response.json();
})
.then(data => {
// ...
})
.catch(error => {
console.error('Error:', error);
// 显示友好的错误信息
alert('An error occurred while fetching data. Please try again later.');
// 记录错误日志
logError(error);
});总而言之,掌握 AJAX 的发送方式,以及错误处理、跨域问题等,能让你在前端开发中更加得心应手。选择 XMLHttpRequest 还是 fetch API,取决于你的项目需求和兼容性考虑。
今天关于《手把手教你用JS写Ajax,超详细教程+代码实例!》的内容就介绍到这里了,是不是学起来一目了然!想要了解更多关于ajax的内容请关注golang学习网公众号!
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
379 收藏
-
104 收藏
-
145 收藏
-
235 收藏
-
203 收藏
-
421 收藏
-
187 收藏
-
495 收藏
-
371 收藏
-
244 收藏
-
121 收藏
-
106 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习