# @actions/http-client 中文文档

规范地址：https://npmcn.com/package/%40actions/http-client/

版本：4\.0\.1
npm 元数据更新时间：2026-06-11T21:11:11.712Z
中文译文更新时间：2026-11-05T16:47:51.614Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40actions/http-client
原文对照：https://npmcn.com/package/%40actions/http-client/?lang=original
项目主页：https://github.com/actions/toolkit/tree/main/packages/http-client
源码仓库：https://github.com/actions/toolkit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：76.2 kB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2020-01-10T04:31:14.027Z
- 最新版本发布：2026-04-21T21:42:26.809Z
- 近 30 天下载量：71728824（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 4 个）

## 中文简介

动作 Http 客户端

## 安装

```sh
npm install @actions/http-client
```

也可以使用：`pnpm add @actions/http-client`、`yarn add @actions/http-client`、`bun add @actions/http-client`

## README

# `@actions/http-client`

一个轻量级的HTTP客户端优化用于构建动作.

## 特征

-   HTTP 客户端带有 TypeScript 通用和ASync/await/ 保证
-   包括打字!
-   [代理支持](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners#using-a-proxy-server-with-self-hosted-runners) 只是与动作和跑者合作
-   目标ES2019(跑者运行有节点24+的动作). 只在节点20+上支持.
-   Basic, Bearer 和 PAT 支援从盒子里出来. 为他人提供广泛的处理器.
-   支持的重定向

特征和释放 [这里](https://npmcn.com/package/%40actions/http-client/RELEASES.md)

## 安装

```
npm install @actions/http-client --save
```

## 样本

见 [测试](https://npmcn.com/package/%40actions/http-client/__tests__) 详细的例子.

## 错误

### HTTP 密码

HTTP 客户端不会抛出, 除非是真正的例外 .

-   成功执行导致404,500等的请求,将返回具有状态代码和正文的响应对象.
-   重定向(3xx)后会出现默认.

见 [测试](https://npmcn.com/package/%40actions/http-client/__tests__) 详细的例子.

## 调试

为了能够对所有 HTTP 请求和响应进行详细的控制台记录,设置 NODE DEBUG 环境可渗透 :

```shell
export NODE_DEBUG=http
```

## 节点支持

Http客户端使用24号节点构建. 它可能在之前的节点LTS版本上工作,但在节点20+上测试并正式支持.

## 支持和版本

我们跟踪模拟器,并将保持主要版本与带有新特性和能力(同时持有相容性)的小版本之间的相容性.

## 捐款

我们欢迎公关 请在进行代码处理前先创建一个问题,并在适用的情况下创建一个设计.

一次:

```
npm install
```

为建设:

```
npm run build
```

进行所有测试:

```
npm test
```

## 常见问题

### @actions/http-client 是什么？

动作 Http 客户端

### 如何安装 @actions/http-client？

在项目目录运行 npm install @actions/http-client，或使用 pnpm add / yarn add / bun add。

### @actions/http-client 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @actions/http-client 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @actions/http-client 可以商用吗？

@actions/http-client 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @actions/http-client 的下载量有多少？

根据 npm 官方下载统计，@actions/http-client 在 2026/10/05 – 2026/11/03 这 30 天内被下载 71,728,824 次，日均约 2,390,961 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @actions/http-client 还在维护吗？

最新版本 4\.0\.1 发布于 2026/04/22（6 个月前）；至今共发布 25 个版本，其中过去 12 个月发布了 4 个；首次发布于 2020/01/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。