deployphp/node_modules/@actions/http-client/README.md

74 lines
1.8 KiB
Markdown
Raw Normal View History

2023-01-10 14:46:25 +00:00
# `@actions/http-client`
2021-10-15 20:41:54 +00:00
2023-01-10 14:46:25 +00:00
A lightweight HTTP client optimized for building actions.
2021-10-15 20:41:54 +00:00
## Features
- HTTP client with TypeScript generics and async/await/Promises
2023-01-10 14:46:25 +00:00
- Typings included!
2021-10-15 20:41:54 +00:00
- [Proxy support](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners#using-a-proxy-server-with-self-hosted-runners) 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](./RELEASES.md)
## Install
```
npm install @actions/http-client --save
```
## Samples
2023-01-10 14:46:25 +00:00
See the [tests](./__tests__) for detailed examples.
2021-10-15 20:41:54 +00:00
## 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.
2023-01-10 14:46:25 +00:00
See the [tests](./__tests__) for detailed examples.
2021-10-15 20:41:54 +00:00
## Debugging
To enable detailed console logging of all HTTP requests and responses, set the NODE_DEBUG environment varible:
2023-01-10 14:46:25 +00:00
```shell
2021-10-15 20:41:54 +00:00
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:
2023-01-10 14:46:25 +00:00
```
npm install
2021-10-15 20:41:54 +00:00
```
To build:
2023-01-10 14:46:25 +00:00
```
npm run build
2021-10-15 20:41:54 +00:00
```
To run all tests:
2023-01-10 14:46:25 +00:00
```
npm test
2021-10-15 20:41:54 +00:00
```