Fetch API 是浏览器原生异步请求接口,基于 Promise 但默认不带 Cookie、不自动处理 HTTP 错误状态码;需手动检查 response.ok、设置 credentials 和 headers,用 AbortController 实现超时控制。

Fetch API 是浏览器原生提供的、用于发起网络请求的 JavaScript 接口,它比 XMLHttpRequest 更简洁、更符合现代异步编程习惯(基于 Promise),但默认不带 Cookie、不自动处理 4xx/5xx 状态码,这些是实际用时最容易出问题的地方。
Fetch 基本用法:GET 请求怎么写才不会卡住
最简 GET 请求只需一个 URL 参数,但必须注意:返回的是 Promise,且 response 对象不是直接的 JSON 数据。
-
fetch()返回 Promise,需用.then()或await处理;直接console.log(fetch('/api/user'))看不到数据,只看到 pending Promise -
response.json()也返回 Promise,要链式调用或 await 两次;漏掉这一步会得到ReadableStream而非对象 - 没有网络或跨域失败时,Promise 会 reject;但 HTTP 状态码为 404、500 时,Promise 仍 resolve,需手动检查
response.ok或response.status
示例:
fetch('/api/user')
.then(response => {
if (!response.ok) throw new Error(`HTTP ${response.status}`);
return response.json();
})
.then(data => console.log(data))
.catch(err => console.error('请求失败:', err));
POST 请求发不出去?检查这几个关键配置
发 POST 时常见 400 或后端收不到 body,通常是因为没设 Content-Type、body 格式不匹配,或忘记把对象转成字符串。
立即学习“Java免费学习笔记(深入)”;
- 必须显式设置
headers:发送 JSON 时加'Content-Type': 'application/json';表单用'application/x-www-form-urlencoded' -
body必须是字符串或FormData实例;JSON.stringify({id: 1})是合法的,{id: 1}直接传会报错 - 需要携带 Cookie 时,必须加
credentials: 'include'(默认是'omit'),否则登录态丢失
示例(JSON POST):
fetch('/api/login', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
credentials: 'include',
body: JSON.stringify({ username: 'admin', password: '123' })
});
为什么 fetch 没有超时控制?得自己加
Fetch API 本身不支持 timeout 选项,网络卡死时 Promise 会一直 pending。必须靠 AbortController 主动中断。
- 创建
const controller = new AbortController(),把signal传入fetch()的options - 用
setTimeout(() => controller.abort(), 8000)模拟超时;触发后 Promise 会 reject 并抛出AbortError - 注意:
AbortController在 Node.js 中不可用,仅限浏览器环境
示例:
const controller = new AbortController();
setTimeout(() => controller.abort(), 8000);
fetch('/api/data', { signal: controller.signal })
.catch(err => {
if (err.name === 'AbortError') console.log('请求已超时');
});
和 axios 比,Fetch 缺少哪些“开箱即用”的能力
Fetch 是底层原语,axios 是封装层。真正影响开发效率的差异集中在错误处理、默认行为和调试支持上。
- Fetch 不自动 reject HTTP 错误状态(404/500),axios 会
- Fetch 默认不发 Cookie,axios 默认发(
withCredentials: true) - Fetch 没有全局拦截器(如请求前加 token、响应后统一解包),axios 有
axios.interceptors - Fetch 的错误类型分散(网络失败、abort、JSON 解析失败),axios 统一为
AxiosError,方便判断
如果你项目里反复写 if (!response.ok) 和 credentials: 'include',说明你其实在重复造 axios 的轮子。











