JavaScript / TypeScript / 系统课时

使用 Fetch 发起请求

使用 Fetch 发起请求

本篇解决浏览器中如何通过 JavaScript 访问远程数据的问题。你将使用 Fetch 发起 GET 请求,读取响应对象,并把服务器返回的 JSON 数据转换为可操作的 JavaScript 对象。

学习目标

  • 理解 Fetch 请求的基本流程和 Promise 返回机制
  • 掌握响应对象的读取方式以及 JSON 数据解析
  • 学会判断网络请求失败并进行基础错误处理

发起第一个 Fetch 请求

Fetch 是浏览器提供的现代网络请求 API,用于替代传统的 XMLHttpRequest。它基于 Promise 工作,可以通过链式调用处理异步响应。

一个 GET 请求通常包含三个步骤:发送请求、检查响应状态、读取响应数据。

js
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);
  });

预期输出

text
服务器返回的用户数据对象,例如:
[{"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 代码,让异步流程更接近同步阅读方式。

js
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);
});

预期输出

text
服务器返回的用户数组,例如:
[{"id":1,"name":"Alice"}]

async/await 只是 Promise 的另一种写法,底层执行逻辑仍然是异步任务,不会阻塞浏览器页面运行。

请求失败判断与边界处理

编写 Fetch 请求时,需要分别处理不同类型的问题:

  • 网络无法连接:例如断网、DNS 失败,请求会进入 catch。
  • HTTP 请求失败:例如 404、500,需要检查 response.ok。
  • 数据格式错误:例如服务器返回非 JSON,需要捕获解析异常。

在真实项目中,不应直接假设接口永远返回正确数据,而应该在读取响应前完成状态检查,并在页面中展示合理的错误信息。

什么时候不该使用 Fetch

如果项目需要自动重试、请求取消、复杂拦截器或统一请求管理,直接使用 Fetch 可能需要额外封装。大型应用通常会在 Fetch 之上建立自己的请求层。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Fetch 发起请求

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

登录哪都通