actions/http-client
1
0
Fork 0
mirror of https://github.com/actions/http-client.git synced 2025-02-24 16:22:28 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
A lightweight HTTP client optimized for use with actions, TypeScript with generics and async await.
27 Commits 17 Branches 0 Tags 369 KiB
TypeScript 99.6%
JavaScript 0.4%
9827426984
Go to file
Bryan MacFarlane 9827426984 json apis
2020-02-01 18:39:08 -05:00
__tests__ json apis 2020-02-01 18:39:08 -05:00
.github/workflows fix 2020-01-23 09:25:39 -05:00
.gitignore initial commit 2020-01-09 18:32:59 -05:00
actions.png readme 2020-01-09 23:08:26 -05:00
auth.ts code review 2020-01-10 18:12:28 -05:00
index.ts json apis 2020-02-01 18:39:08 -05:00
interfaces.ts json apis 2020-02-01 18:39:08 -05:00
jest.config.js initial commit 2020-01-09 18:32:59 -05:00
LICENSE code review 2020-01-10 18:12:28 -05:00
package-lock.json fix 2020-01-23 09:25:39 -05:00
package.json fix 2020-01-23 09:25:39 -05:00
proxy.ts fix bugs related no_proxy and ports: 1) https://foo.com should match no_proxy=foo.com:443 and 2) https://foo.com:8080 should match no_proxy=foo.com 2020-01-22 23:09:35 -05:00
README.md update 2020-01-10 15:44:01 -05:00
tsconfig.json Revert unnecessary changes 2020-01-11 21:23:55 -05:00

README.md

Actions Http-Client

Http Status

A lightweight HTTP client optimized for use with actions, TypeScript with generics and async await.

Features

  • HTTP client with TypeScript generics and async/await/Promises
  • Typings included so no need to acquire separately (great for intellisense and no versioning drift)
  • 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

Install

npm install @actions/http-client --save

Samples

See the HTTP 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 HTTP 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. We also support the latest LTS for Node 6, 8 and Node 10.

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