JavaScript / TypeScript / 系统课时
使用 Fetch 发起请求
使用 Fetch 发起请求
本篇解决浏览器中如何通过 JavaScript 访问远程数据的问题。你将使用 Fetch 发起 GET 请求,读取响应对象,并把服务器返回的 JSON 数据转换为可操作的 JavaScript 对象。
学习目标
- 理解 Fetch 请求的基本流程和 Promise 返回机制
- 掌握响应对象的读取方式以及 JSON 数据解析
- 学会判断网络请求失败并进行基础错误处理
发起第一个 Fetch 请求
Fetch 是浏览器提供的现代网络请求 API,用于替代传统的 XMLHttpRequest。它基于 Promise 工作,可以通过链式调用处理异步响应。
一个 GET 请求通常包含三个步骤:发送请求、检查响应状态、读取响应数据。
fetch("https://api.example.com/users")
.then((response) => {
if (!response.ok) {
throw new Error("请求失败");
}
return response.json();
})
.then((data) => {
console.log(data);
})
.catch((error) => {
console.error(error.message);
});预期输出
服务器返回的用户数据对象,例如:
[{"id":1,"name":"Alice"}]Fetch 返回的是 Promise,而不是直接返回服务器数据。第一次 then 接收到的是 Response 对象,需要继续调用 json() 才能读取响应正文。
理解 Response 对象
Fetch 请求成功后,浏览器会返回一个 Response 对象,它包含状态码、响应头以及读取数据的方法。
常用属性和方法如下:
| 属性或方法 | 作用 |
|---|---|
response.ok |
判断 HTTP 状态码是否表示成功 |
response.status |
获取 HTTP 状态码 |
response.headers |
获取响应头信息 |
response.json() |
将 JSON 响应转换为 JavaScript 对象 |
response.text() |
读取普通文本响应 |
需要注意的是,HTTP 错误状态例如 404 或 500 不会自动进入 catch。只有网络异常或代码主动抛出错误时,Promise 才会进入异常处理流程。
使用 async 和 await 简化请求
实际项目中更常使用 async/await 编写 Fetch 代码,让异步流程更接近同步阅读方式。
async function loadUsers() {
const response = await fetch("https://api.example.com/users");
if (!response.ok) {
throw new Error(`HTTP 错误: ${response.status}`);
}
const users = await response.json();
console.log(users);
}
loadUsers().catch((error) => {
console.error(error.message);
});预期输出
服务器返回的用户数组,例如:
[{"id":1,"name":"Alice"}]async/await 只是 Promise 的另一种写法,底层执行逻辑仍然是异步任务,不会阻塞浏览器页面运行。
请求失败判断与边界处理
编写 Fetch 请求时,需要分别处理不同类型的问题:
- 网络无法连接:例如断网、DNS 失败,请求会进入 catch。
- HTTP 请求失败:例如 404、500,需要检查
response.ok。 - 数据格式错误:例如服务器返回非 JSON,需要捕获解析异常。
在真实项目中,不应直接假设接口永远返回正确数据,而应该在读取响应前完成状态检查,并在页面中展示合理的错误信息。
什么时候不该使用 Fetch
如果项目需要自动重试、请求取消、复杂拦截器或统一请求管理,直接使用 Fetch 可能需要额外封装。大型应用通常会在 Fetch 之上建立自己的请求层。