从Axios迁移到Got的技术指南

从Axios迁移到Got的技术指南

got 🌐 Human-friendly and powerful HTTP request library for Node.js 项目地址: https://gitcode.com/gh_mirrors/go/got

前言

Got是一个功能强大且专注于Node.js环境的HTTP请求库，与Axios相比，它更充分地利用了Node.js的特性。本文将为开发者提供从Axios迁移到Got的详细指南，帮助开发者理解两者之间的差异并顺利完成迁移。

核心差异概述

Got与Axios的主要区别在于设计理念和目标平台：

1. 平台专注性：Axios主要针对浏览器环境设计，而Got则是专为Node.js环境优化的HTTP客户端
2. API设计：Got的API设计更符合Node.js的惯用模式，提供了更丰富的Node.js特有功能
3. 性能优化：Got针对Node.js环境进行了深度优化，在处理大量请求时表现更佳

选项映射与重命名

保持不变的选项

以下选项在Got中与Axios保持完全一致：

• url - 请求URL
• method - HTTP方法
• headers - 请求头
• maxRedirects - 最大重定向次数
• decompress - 是否自动解压缩响应

重命名的选项

Got为了提高可读性，对一些选项进行了重命名：

| Axios选项 | Got对应选项 | 说明 | |-----------|------------|------| | httpAgent | agent.http | HTTP连接配置 | | httpsAgent | agent.https | HTTPS连接配置 | | socketPath | url | Unix域套接字路径 | | responseEncoding | encoding | 响应编码格式 | | auth.username | username | 基本认证用户名 | | auth.password | password | 基本认证密码 | | data | body/json/form | 请求体数据，根据内容类型选择 | | params | searchParams | URL查询参数 |

行为变更的选项

1. 请求/响应转换：

   • transformRequest → hooks.beforeRequest
   • transformResponse → hooks.afterResponse
   • Got的钩子系统提供了更灵活的API

2. 基础URL：

   • baseUrl → prefixUrl
   • prefixUrl会自动拼接到url前

3. 超时控制：

   • Got将超时配置改为对象形式，可以针对不同事件设置超时

4. 响应类型：

   • Got仅支持'text'、'json'或'buffer'三种响应类型

不再支持的选项

以下Axios选项在Got中不再支持，需要寻找替代方案：

1. 进度事件：

   • 使用got(...).on('uploadProgress', ...)替代onUploadProgress
   • 使用got(...).on('downloadProgress', ...)替代onDownloadProgress

2. 内容长度限制：

   • 需要自定义处理器来实现类似maxContentLength的功能

3. 状态验证：

   • Got自动按照HTTP规范验证状态码

4. 连接配置：

   • 需要通过agent选项配置连接

5. 取消令牌：

   • 暂时使用promise.cancel()或stream.destroy()

响应对象差异

Got的响应对象与Axios有所不同：

| Axios属性 | Got对应属性 | 说明 | |-----------|------------|------| | data | body | 响应体内容 | | status | statusCode | HTTP状态码 | | statusText | statusMessage | 状态消息 | | config | request.options | 请求配置 | | - | request | 返回Got流 |

headers对象保持不变。

拦截器与钩子系统

Got使用钩子系统替代了Axios的拦截器，提供了更强大的功能：

1. beforeRequest - 请求发送前钩子
2. afterResponse - 收到响应后钩子
3. beforeError - 错误处理前钩子

钩子系统允许更细粒度的控制和更灵活的请求/响应处理流程。

错误处理

Got的错误对象与Axios类似，但提供了更多调试信息：

1. error.request返回Got流
2. 错误对象包含更多上下文信息
3. 错误类型更丰富，便于针对性处理

取消请求

虽然Got目前不支持AbortController，但可以通过以下方式取消请求：

1. 对于Promise：promise.cancel()
2. 对于流：stream.destroy()

便捷方法与实例创建

Got提供了与Axios类似的便捷方法：

1. got.get(...) - GET请求
2. got.post(...) - POST请求
3. got.extend(...) - 创建自定义实例（替代axios.create）

迁移建议

1. 逐步迁移：可以先在非关键路径尝试迁移
2. 测试覆盖：确保充分测试所有HTTP交互
3. 性能监控：迁移后监控应用性能变化
4. 错误处理：特别注意错误处理逻辑的调整

结语

从Axios迁移到Got是一个值得投入的过程，Got为Node.js环境提供了更优化的HTTP客户端解决方案。通过本文的指南，开发者可以顺利完成迁移，并充分利用Got提供的强大功能。如果在迁移过程中遇到任何问题，建议详细查阅Got的官方文档，其中包含了丰富的示例和最佳实践。

got 🌐 Human-friendly and powerful HTTP request library for Node.js 项目地址: https://gitcode.com/gh_mirrors/go/got