Fetch API 是浏览器内置的现代网络请求接口,基于 Promise,语法简洁,支持多种响应类型;注意其仅在网络失败时拒绝 Promise,HTTP 错误需手动检查 response.ok 或 status。
Fetch API 是浏览器内置的、用于发起网络请求的现代 JavaScript 接口,用来替代传统的 XMLHttpRequest。它基于 Promise,语法更简洁,逻辑更清晰,支持 JSON、文本、图片、流等多种响应类型。
最简单的 GET 请求只需一行代码:
fetch('https://api.example.com/data') 返回一个 Promise,成功时解析为 Response 对象。
注意:fetch 只在**网络失败(如断网、DNS 错误)时拒绝 Promise**;HTTP 错误状态(如 404、500)仍会进入 then,需手动检查 response.ok 或 response.status。
.then(res => res.json()) 解析 JSON 响应.then(res => res.text()) 获取纯文本.catch(err => console.error(err)) 捕获网络异常发送表单数据或 JSON 数据时,需配置 options 参数:
fetch('/login', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ username: 'admin', password: '123' })
})
method 默认是 GET,POST/PUT/DELETE 需显式声明headers 控制请求头,发送 JSON 时通常要设 Content-Type
body 必须是字符串、FormData、Blob 或 URLSearchParams,不能直接传对象实际项目中建议封装一层,统一处理常见逻辑:
response.ok 判断 HTTP 状态是否在 200–299 范围catch 统一处理AbortController 实现)用 async/await 替代链式 then,让异步代码像同步一样直观:
async function getUser() {
try {
const res = await fetch('/api/user');
if (!res.ok) thr
ow new Error(`HTTP error: ${res.status}`);
const data = await res.json();
return data;
} catch (err) {
console.error('获取用户失败:', err);
}
}
这样写逻辑清晰,错误处理集中,也方便复用和测试。