封装统一的请求工具函数需要创建一个核心函数,通过配置对象接收url、方法、参数和超时设置,内部使用原生 fetch api 发起请求并处理响应。该函数应统一拦截 http 错误状态码,将非 2xx 响应转换为标准的 javascript error 对象抛出,同时自动解析 json 数据或返回文本,从而为上层业务提供一致且健壮的调用接口。

如何设计支持多种 HTTP 方法的通用请求函数
设计通用请求函数的关键在于抽象出 method、url 和 body 等核心参数,并利用默认参数语法简化常见场景的调用。通过定义一个名为 request 的主函数,可以接受一个包含这些属性的配置对象,并在内部根据 method 的值动态构建 fetch 选项。这种设计允许开发者只需传入不同的配置即可执行 GET、POST 或其他自定义方法,而无需重复编写基础的请求逻辑。

function request(config) {
const { url, method = 'GET', data, headers = {} } = config;
const options = {
method,
headers: { 'Content-Type': 'application/json', ...headers },
body: method !== 'GET' && data ? JSON.stringify(data) : undefined
};
return fetch(url, options).then(res => {
if (!res.ok) throw new Error(`HTTP ${res.status}`);
return res.json();
});
}
// 调用示例
request({ url: '/api/users', method: 'POST', data: { name: 'Alice' } })
.then(console.log); // 输出: { id: 1, name: 'Alice' }
上述代码展示了如何通过解构赋值提取配置项,并合并默认的 Content-Type 头部。当 method 不是 GET 时,会将 data 序列化为 JSON 字符串放入请求体中。如果服务器返回成功状态码,则直接解析 JSON;否则抛出包含状态码的错误信息。这种实现方式确保了所有请求都遵循相同的错误处理和数据解析规范。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
如何处理请求超时与网络异常
处理请求超时和网络异常需要引入 AbortController 来管理请求的生命周期,并结合 Promise.race 实现超时控制。在发起 fetch 请求的同时,创建一个定时器,如果在指定时间内请求未完成,则主动中止请求并抛出超时错误。此外,还需要捕获网络断开等底层异常,确保无论发生何种故障,调用者都能收到明确的拒绝原因,而不是让 Promise 挂起。

function requestWithTimeout(config, timeout = 5000) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), timeout);
return fetch(config.url, {
...config,
signal: controller.signal,
body: config.data ? JSON.stringify(config.data) : undefined
}).finally(() => clearTimeout(timeoutId))
.catch(err => {
if (err.name === 'AbortError') throw new Error('Request Timeout');
throw err;
});
}
// 调用示例
requestWithTimeout({ url: '/api/slow', data: { key: 'value' } }, 2000)
.catch(e => console.error(e.message)); // 输出: Request Timeout
在这个增强版函数中,AbortController 的 signal 被传递给 fetch,使得外部可以通过调用 abort() 来中断请求。定时器在设定的毫秒数后触发中止操作,随后 finally 块清理定时器以避免内存泄漏。当捕获到 AbortError 时,将其转换为更具可读性的“Request Timeout”错误,其他网络错误则原样抛出。这样既保证了请求的可控性,又提升了用户体验。
基于程序中某个输入、条件或结果的具体问题
当传入的 data 参数为 null 或未定义时,程序会正确地将请求体设置为 undefined,从而避免发送空的 JSON 字符串 null。这一行为符合大多数 RESTful API 的预期,即 GET 请求不应携带 Body,而 POST/PUT 请求若未提供数据则不发送 Body 字段。通过三元运算符 method !== 'GET' && data ? JSON.stringify(data) : undefined 的判断,确保了只有在方法非 GET 且数据存在时才进行序列化,否则保持 undefined,防止因无效 Body 导致的服务器端解析错误或语义歧义。

















