mirror of
https://github.com/softprops/action-gh-release.git
synced 2025-06-28 14:16:02 +00:00
105 lines
2.5 KiB
Markdown
105 lines
2.5 KiB
Markdown
# plugin-retry.js
|
|
|
|
> Retries requests for server 4xx/5xx responses except `400`, `401`, `403` and `404`.
|
|
|
|
[](https://www.npmjs.com/package/@octokit/plugin-retry)
|
|
[](https://github.com/octokit/plugin-retry.js/actions?workflow=Test)
|
|
|
|
## Usage
|
|
|
|
<table>
|
|
<tbody valign=top align=left>
|
|
<tr><th>
|
|
Browsers
|
|
</th><td width=100%>
|
|
|
|
Load `@octokit/plugin-retry` and [`@octokit/core`](https://github.com/octokit/core.js) (or core-compatible module) directly from [cdn.pika.dev](https://cdn.pika.dev)
|
|
|
|
```html
|
|
<script type="module">
|
|
import { Octokit } from "https://cdn.pika.dev/@octokit/core";
|
|
import { retry } from "https://cdn.pika.dev/@octokit/plugin-retry";
|
|
</script>
|
|
```
|
|
|
|
</td></tr>
|
|
<tr><th>
|
|
Node
|
|
</th><td>
|
|
|
|
Install with `npm install @octokit/core @octokit/plugin-retry`. Optionally replace `@octokit/core` with a core-compatible module
|
|
|
|
```js
|
|
const { Octokit } = require("@octokit/core");
|
|
const { retry } = require("@octokit/plugin-retry");
|
|
```
|
|
|
|
</td></tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
**Note**: If you use it with `@octokit/rest` v16, install `@octokit/core` as a devDependency. This is only temporary and will no longer be necessary with `@octokit/rest` v17.
|
|
|
|
```js
|
|
const MyOctokit = Octokit.plugin(retry);
|
|
const octokit = new MyOctokit({ auth: "secret123" });
|
|
|
|
// retries request up to 3 times in case of a 500 response
|
|
octokit.request("/").catch((error) => {
|
|
if (error.request.request.retryCount) {
|
|
console.log(
|
|
`request failed after ${error.request.request.retryCount} retries`
|
|
);
|
|
}
|
|
|
|
console.error(error);
|
|
});
|
|
```
|
|
|
|
To override the default `doNotRetry` list:
|
|
|
|
```js
|
|
const octokit = new MyOctokit({
|
|
auth: "secret123",
|
|
retry: {
|
|
doNotRetry: [
|
|
/* List of HTTP 4xx/5xx status codes */
|
|
],
|
|
},
|
|
});
|
|
```
|
|
|
|
To override the number of retries:
|
|
|
|
```js
|
|
const octokit = new MyOctokit({
|
|
auth: "secret123",
|
|
request: { retries: 1 },
|
|
});
|
|
```
|
|
|
|
You can manually ask for retries for any request by passing `{ request: { retries: numRetries, retryAfter: delayInSeconds }}`
|
|
|
|
```js
|
|
octokit
|
|
.request("/", { request: { retries: 1, retryAfter: 1 } })
|
|
.catch((error) => {
|
|
if (error.request.request.retryCount) {
|
|
console.log(
|
|
`request failed after ${error.request.request.retryCount} retries`
|
|
);
|
|
}
|
|
|
|
console.error(error);
|
|
});
|
|
```
|
|
|
|
Pass `{ retry: { enabled: false } }` to disable this plugin.
|
|
|
|
## Contributing
|
|
|
|
See [CONTRIBUTING.md](CONTRIBUTING.md)
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE)
|