17370845950

Fetch API 是浏览器内置的现代网络请求接口，基于 Promise，支持 async/await；GET/POST 请求需手动处理 HTTP 错误和 JSON 解析，注意 credentials、超时及进度等限制。

Fetch API 是浏览器内置的、用于发起网络请求的现代 JavaScript 接口，它比传统的 XMLHttpRequest 更简洁、更强大，基于 Promise，天然支持 async/await。

基本用法：发起一个 GET 请求

最简单的 fetch 调用只需要传入一个 URL 字符串：

fetch('https://api.example.com/data')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('请求失败:', error));

• fetch 返回一个 Promise，代表响应的未来值
• 注意：fetch 只在发生网络错误（如断网）时 reject；HTTP 状态码如 404、500 不会触发 catch，需手动检查 response.ok 或 response.status
• response.json() 也返回 Promise，要等它解析完才能拿到真正的数据

发送 POST 请求并携带 JSON 数据

需要配置 options 对象，指定 method、headers 和 body：

const data = { username: 'alice', password: '123' };

fetch('https://api.example.com/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(data)
})
.then(res => {
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
})
.then(json => console.log(json))
.catch(err => console.error(err));

• body 必须是字符串、Blob、FormData 等可序列化类型；JSON 需先用 JSON.stringify()
• 手动检查 res.ok（等价于 status 在 200–299 区间），避免把服务端错误当成功处理
• 设置 Content-Type 头让后端知道你发的是 JSON

使用 async/await 让代码更清晰

配合 async 函数，可以写出接近同步风格的请求逻辑：

async function getUser(id) {
  try {
    const res = await fetch(`/api/users/${id}`);
    if (!res.ok) throw new Error(res.statusText);
    const user = await res.json();
    return user;
  } catch (err) {
    console.error('获取用户失败:', err);
    throw err;
  }
}

// 调用
getUser(123).then(u => console.log(u));

• await 会暂停函数执行，直到 Promise settle，写起来更直观
• 推荐始终用 try/catch 包裹 await 表达式，统一处理网络和解析错误
• 多个 await 可以按顺序执行，也可用 Promise.all 并发请求

常见注意事项

• 默认不带 cookie：跨域请求需显式加 credentials: 'include'
• 没有超时控制：fetch 本身不支持 timeout，需用 AbortController 手动中断
• 不自动重定向到登录页：遇到 401/403 应由前端判断并跳转，fetch 不会“跳转”
• 不支持 progress 事件：上传进度需用 XMLHttpRequest 或第三方库（如 axios）

基本上就这些。fetch 简洁够用，日常开发中搭配 async/await 和简单的错误检查，就能覆盖绝大多数场景。