actions
/
toolkit
mirror of https://github.com/actions/toolkit
1
0
Fork 0
Code
toolkit/packages/http-client
History
Brian Cristante aa676f3cc7
Update other packages to use http-client v2 (#1082) 
We moved `@actions/http-client` to be part of the toolkit in https://github.com/actions/toolkit/pull/1062.  We also made some breaking changes to exported types and released v2.

The biggest change in terms of lines of code affected was to get rid of the `I-` prefix for interfaces since TypeScript doesn't follow this convention.

I bumped the patch version of all packages except for `tool-cache`, where I bumped the major version.  The rationale is explained in the release notes for that package.
 		2022-05-11 17:14:25 -04:00
..
__tests__ Move @actions/http-client into the toolkit (#1062) 2022-05-03 11:10:13 -04:00
src Move @actions/http-client into the toolkit (#1062) 2022-05-03 11:10:13 -04:00
.gitignore Move @actions/http-client into the toolkit (#1062) 2022-05-03 11:10:13 -04:00
LICENSE Move @actions/http-client into the toolkit (#1062) 2022-05-03 11:10:13 -04:00
README.md Move @actions/http-client into the toolkit (#1062) 2022-05-03 11:10:13 -04:00
RELEASES.md Move @actions/http-client into the toolkit (#1062) 2022-05-03 11:10:13 -04:00
package-lock.json Move @actions/http-client into the toolkit (#1062) 2022-05-03 11:10:13 -04:00
package.json Update other packages to use http-client v2 (#1082) 2022-05-11 17:14:25 -04:00
tsconfig.json Move @actions/http-client into the toolkit (#1062) 2022-05-03 11:10:13 -04:00

README.md

@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 12+). Only supported on node 12+.
  • 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 the latest LTS version of Node 12. It may work on previous node LTS versions but it's tested and officially supported on Node12+.

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