@actions/http-client

@actions/http-client

A lightweight HTTP client optimized for building actions.

Features

• HTTP client with TypeScript generics and async/await/Promises
• Typings included!
• Proxy support just works with actions and the runner
• Targets ES2019 (runner runs actions with node 24+). Only supported on node 20+.
• Basic, Bearer and PAT Support out of the box. Extensible handlers for others.
• Redirects supported

Features and releases here

Install

npm install @actions/http-client --save

Samples

See the tests for detailed examples.

Errors

HTTP

The HTTP client does not throw unless truly exceptional.

• A request that successfully executes resulting in a 404, 500 etc... will return a response object with a status code and a body.
• Redirects (3xx) will be followed by default.

See the tests for detailed examples.

Debugging

To enable detailed console logging of all HTTP requests and responses, set the NODE_DEBUG environment varible:

export NODE_DEBUG=http

Node support

The http-client is built using Node 24. It may work on previous node LTS versions but it's tested and officially supported on Node 20+.

Support and Versioning

We follow semver and will hold compatibility between major versions and increment the minor version with new features and capabilities (while holding compat).

Contributing

We welcome PRs. Please create an issue and if applicable, a design before proceeding with code.

once:

npm install

To build:

npm run build

To run all tests:

npm test

Similar packages

Other packages similar to @actions/http-client

axios

Axios is a popular HTTP client for the browser and Node.js. It provides a promise-based API and has a similar feature set to @actions/http-client, including the ability to make various HTTP requests, intercept requests and responses, and transform request and response data. Axios is often preferred for its simplicity and wide adoption.

node-fetch

node-fetch is a light-weight module that brings the Fetch API to Node.js. It is similar to @actions/http-client in that it allows you to make HTTP requests, but it is designed to closely mimic the browser fetch API, which some developers may find more familiar.

got

Got is a human-friendly and powerful HTTP request library for Node.js. It offers features like stream support, retries, and request cancellation, which are similar to @actions/http-client. Got is known for its advanced features and comprehensive options for customizing requests.

superagent

Superagent is a small progressive client-side HTTP request library, and Node.js module with the same API, sporting many high-level HTTP client features. It compares to @actions/http-client with its fluent API and ability to handle both callback and promise-based workflows.