Fetch 是现代浏览器及 Node.js 提供的 Web API。Axios 是 HTTP 客户端库,支持共用配置、请求与响应转换及拦截器。两者都能读取 JSON。选型时,可以在实际运行环境里比较错误处理、时限和网络路由。
少量浏览器请求通常可直接使用 Fetch。请求较多且需要统一默认配置与拦截器时,可以考虑 Axios。浏览器的 CORS 规则对两者都适用。
本篇目录
对比浏览器与 Node.js 的需求
需求 | Axios | Fetch |
|---|---|---|
读取 JSON 响应 | 通常从 | 显式调用 |
处理 HTTP 404 | 默认 | 返回 Response,由调用方检查 |
限制请求时长 |
| 传入 AbortSignal,运行时支持时可用 |
共用请求策略 | 实例和拦截器 | 包装函数或框架集成 |
浏览器跨域请求 | 受 CORS 和 Cookie 规则约束 | 受 CORS 和 Cookie 规则约束 |
Node.js 代理路由 | 取决于适配器,Node HTTP 适配器支持代理配置 | 取决于运行时或 HTTP 实现,例如使用 Undici dispatcher |
将 Node.js 示例移到浏览器前,先核对适配器和运行时版本。接口详情见 Axios 请求配置和 MDN Fetch 指南。
让两种客户端采用相同的响应约定
附带示例使用 Axios 1.20.0,以及内置 Fetch 和 AbortSignal.timeout() 的 Node.js 环境。依赖版本由锁文件固定。按照 README 准备并启动虚构的本地服务器后运行:
npm ci
node axios_fetch.mjs以下两种实现都将非 2xx 状态和无效 JSON 作为失败处理:
import axios from 'axios';
const base = 'http://127.0.0.1:8812';
const client = axios.create({
timeout: 2000,
proxy: false,
responseType: 'json',
transitional: { silentJSONParsing: false },
});
async function withAxios(path) {
try {
const response = await client.get(base + path);
return {
client: 'Axios', path,
status: response.status,
ok: response.status >= 200 && response.status < 300,
data: response.data,
};
} catch (error) {
return {
client: 'Axios', path,
status: error.response?.status ?? null,
ok: false,
error: error.code || error.name,
};
}
}
async function withFetch(path) {
let status = null;
try {
const response = await fetch(base + path, {
signal: AbortSignal.timeout(2000),
});
status = response.status;
if (!response.ok) {
throw Object.assign(Error('HTTP ' + status), { status });
}
return {
client: 'Fetch', path, status,
ok: true,
data: await response.json(),
};
} catch (error) {
return {
client: 'Fetch', path,
status: error.status ?? status,
ok: false,
error: error.name,
};
}
}
for (const path of ['/demo/ok', '/demo/missing', '/demo/invalid-json']) {
console.log(JSON.stringify(await withAxios(path)));
console.log(JSON.stringify(await withFetch(path)));
}
const observed = await fetch(base + '/demo/missing');
console.log(JSON.stringify({
case: 'Fetch resolves a 404 response',
status: observed.status,
ok: observed.ok,
}));在这个例子中,显式的 Axios JSON 设置会把无效 JSON 作为解析错误。其他响应类型和 transitional 设置可能有不同表现。
先看实际结果,再决定怎样重试
本地端点 | Axios 结果 | 使用上述包装函数的 Fetch 结果 |
|---|---|---|
| HTTP 200,返回 JSON | HTTP 200,返回 JSON |
| HTTP 404,Axios 拒绝 | HTTP 404,包装函数检查状态后拒绝 |
| HTTP 200, | HTTP 200, |
最后发一个不带包装函数的请求,可观察 Fetch 的默认行为:
{"case":"Fetch resolves a 404 response","status":404,"ok":false}传输成功后,服务器仍可能用 HTTP 状态报告资源缺失。仅加 .catch() 捕捉不到 Fetch 的 404。调整 Axios 的 validateStatus 则会改变触发拒绝的状态范围。
JSON 解析失败时保留收到的 HTTP 状态。收到 HTTP 200 后解析报错,应检查响应内容,直接重试可能得到同样的结果。

在浏览器代码里遵循浏览器规则
浏览器或网络配置决定请求路由。Node.js 客户端的代理选项在浏览器中不生效。
跨域 Cookie 需要客户端启用相应选项、服务器配合,并符合浏览器策略。Fetch 的选项是 credentials,Axios 的选项是 withCredentials。JSON 媒体类型或自定义标头也可能触发预检请求。
代理密码和 API 密钥等服务端凭据应由受控的服务端接口处理,避免打包进公开的浏览器代码。
在 Node.js 中显式配置路由
示例包提供一个只连接虚构本地服务的 HTTP 代理,可以独立查看客户端路由配置:
import axios from 'axios';
import { fetch, ProxyAgent } from 'undici';
const target = 'http://127.0.0.1:8812/demo/ok';
const response = await axios.get(target, {
timeout: 2000,
proxy: {
protocol: 'http',
host: '127.0.0.1',
port: 8814,
},
});
console.log(JSON.stringify({
client: 'Axios',
status: response.status,
through_example_proxy: response.headers['x-demo-proxy'] === 'true',
}));
const agent = new ProxyAgent('http://127.0.0.1:8814');
try {
const res = await fetch(target, {
dispatcher: agent,
signal: AbortSignal.timeout(2000),
});
await res.arrayBuffer();
console.log(JSON.stringify({
client: 'Undici Fetch',
status: res.status,
through_example_proxy: true,
}));
} finally {
await agent.close();
}Axios 示例使用 Node HTTP 适配器的代理配置。Fetch 示例从 Undici 导入 Fetch 和 ProxyAgent,由该实现处理 dispatcher 选项。
运行 node proxy_clients.mjs,两个本地请求都返回 HTTP 200。使用真实 MIYAIP 连接时,将本地设置换成账号规定的协议和连接字段。SOCKS 需要使用对应的 agent。连接字段见静态代理文档。
选择能长期维护的请求策略
显式状态检查、少量包装代码和现有路由支持就能满足需求时,可选 Fetch。调用较多且需要管理实例默认值、拦截器和共用配置时,可选 Axios。确定由哪一层负责状态检查、JSON 校验、取消和网络路由。
采集还涉及 HTML 解析、分页和输出校验。Python 网页采集指南展示了使用另一种语言完成这些环节的方式。
常见问题
使用 Axios 就能保证 API 可靠吗?
共用客户端仍需明确超时、预期响应格式及重试策略。对写操作重试前要检查能否安全重复。
Fetch 总能省去依赖吗?
许多运行时内置 Fetch。特定的路由和中间件需求仍可能引入依赖,本文的 Undici 示例就包含一个。
应该单纯为了性能迁移现有代码吗?
用自己的请求模式和运行环境测量。此处的示例只验证两种客户端的处理行为。