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 本身,而是围绕异步过程建立稳定的状态处理流程。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接入远程接口加载数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通