JavaScript / TypeScript / 系统课时
接入远程接口加载数据
接入远程接口加载数据
本篇解决前端项目如何从远程接口获取初始数据,并让页面正确表现加载中、成功和失败三种状态。完成后可以使用 Fetch 构建基础的数据请求流程。
学习目标
- 理解 Fetch 请求的执行流程和 Promise 处理方式。
- 掌握加载状态、成功状态和错误状态的页面管理。
- 能够编写一个可验证的远程数据加载函数。
使用 Fetch 发起数据请求
浏览器提供的 Fetch API 用于发送网络请求并返回 Promise。相比旧式的 XMLHttpRequest,Fetch 更适合使用现代 JavaScript 的异步流程处理请求结果。
一次完整的数据加载通常包含三个阶段:发起请求时显示加载状态,请求成功后解析数据并更新页面,请求失败时展示错误信息。
下面示例从接口获取用户列表数据。示例中的 URL 仅作为接口地址占位,实际项目中应替换为真实后端地址。
js
async function loadUsers() {
const statusElement = document.querySelector('#status');
const listElement = document.querySelector('#user-list');
statusElement.textContent = '加载中...';
try {
const response = await fetch('https://api.example.com/users');
if (!response.ok) {
throw new Error(`请求失败: ${response.status}`);
}
const users = await response.json();
listElement.innerHTML = users
.map(user => `<li>${user.name}</li>`)
.join('');
statusElement.textContent = '加载完成';
} catch (error) {
statusElement.textContent = '数据加载失败';
console.error(error.message);
}
}
loadUsers();预期结果
text
页面首先显示“加载中...”。
接口返回有效数据后显示用户列表,并显示“加载完成”。
请求异常时显示“数据加载失败”。处理 HTTP 错误与网络错误
Fetch 有一个容易忽略的特点:HTTP 404 或 500 等状态码不会自动进入 catch。只有网络层失败时 Promise 才会 reject。
因此业务代码通常需要通过 response.ok 主动判断 HTTP 状态,再决定是否抛出异常。
常见处理方式如下:
- 请求发送失败:网络不可用、跨域限制、服务器无法访问。
- HTTP 返回失败:接口存在但返回错误状态码。
- 数据格式错误:请求成功但响应内容不符合预期。
管理页面数据状态
实际项目中,接口请求通常会影响多个页面状态。简单页面可以使用变量管理,复杂项目会交给状态管理工具统一维护。
推荐至少区分以下状态:
| 状态 | 用户看到的内容 |
|---|---|
| loading | 加载提示或骨架屏 |
| success | 展示接口返回的数据 |
| error | 展示错误提示和重试入口 |
不要在请求开始后立即清空所有旧数据,否则用户可能因为短暂网络延迟看到空白页面。
接入接口时的验证方法
调试远程接口时,可以先在浏览器开发者工具的 Network 面板确认请求是否发送,再检查响应状态和返回内容。
如果页面没有更新,应优先检查三个位置:请求地址是否正确、响应数据结构是否符合代码预期、DOM 选择器是否找到目标元素。
远程数据加载的核心不是调用 Fetch 本身,而是围绕异步过程建立稳定的状态处理流程。
按自己的节奏,确认真正理解。