up-fetch v1.3.0 版本发布：增强请求体处理与配置灵活性

2025-07-04 22:32:07作者：滕妙奇

up-fetch 是一个基于原生 fetch API 的轻量级封装库，旨在提供更便捷、更灵活的 HTTP 请求体验。它通过中间件机制和配置预设功能，简化了常见请求场景的处理逻辑，同时保持了与原生 API 的良好兼容性。

新增功能：isJsonifiable 实用工具

v1.3.0 版本引入了一个新的实用工具函数 isJsonifiable，用于判断一个值是否可以被安全地转换为 JSON 格式。这个工具函数在处理请求体时特别有用，可以帮助开发者避免在序列化不可 JSON 化的值时出现意外错误。

在实际应用中，我们经常会遇到需要判断一个对象是否可以被 JSON.stringify 处理的情况。例如，当我们需要发送一个请求时，如果请求体包含不可序列化的内容（如循环引用的对象、函数等），直接调用 JSON.stringify 会导致错误。有了 isJsonifiable，我们可以提前进行安全检查：

if (isJsonifiable(data)) {
  // 安全地进行 JSON 序列化
  const jsonString = JSON.stringify(data);
} else {
  // 处理不可序列化的情况
}

这个工具函数的实现考虑了 JavaScript 中各种可能的数据类型和边缘情况，为开发者提供了可靠的判断依据。

重大变更：请求体处理机制的改进

更灵活的请求体类型支持

本次版本对 serializeBody 选项进行了重要改进。在之前的版本中，serializeBody 只接收可以被 JSON 化的值作为参数。现在，它能够接收任何非空值作为第一个参数，大大提高了灵活性。

这一变化意味着开发者现在可以处理更多类型的请求体，包括但不限于：

FormData
URLSearchParams
Blob
ArrayBuffer
自定义数据结构

类型安全的请求体约束

配合 TypeScript 的类型系统，开发者现在可以通过类型注解来精确控制允许的请求体类型。例如：

const upfetch = up(fetch, () => ({
  serializeBody: (body: FormData) => body,
}));

在这个例子中，我们明确指定 serializeBody 只接受 FormData 类型的请求体。当尝试传递其他类型的请求体时，TypeScript 会在编译时给出错误提示，从而避免运行时问题。

这种类型安全的约束机制特别适合在大型项目中使用，它可以帮助团队保持代码一致性，减少因类型不匹配导致的错误。

配置函数的参数变更

另一个重要的架构调整是关于 up-fetch 配置函数的参数传递方式。在 v1.3.0 之前，配置函数的第二个参数具有功能性签名。现在，up 函数直接接收 fetcher 的参数，使得配置可以基于具体的请求信息进行动态调整。

这种改变带来了更直观的配置方式，开发者现在可以根据请求的 URL 或选项来定制不同的默认行为。例如：

const upfetch = up(fetch, (input, options) => ({
  baseUrl: 'https://example.com',
  timeout: typeof input === 'string' && input.startsWith('/export/') 
    ? 30000 
    : 5000,
}));