npmpackage.info

Gathering detailed insights and metrics for @vercel/fetch-retry

@vercel/fetch-retry

Opinionated `fetch` (with retrying and DNS caching) optimized for use with Node.js

5.1.3

572

JavaScript

4.16 kB

28,715,650 3.3

Installations

npm install @vercel/fetch-retry

Developer Guide

BETA

Typescript

No

Module System

N/A

Score

80.2

Supply Chain

82.8

Quality

82.2

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

58

Closed

20

Merged

38

Issues

Open

1

Total

25

Closed

24

Releases

@vercel/fetch@7.0.0

Updated on Jun 21, 2023

@vercel/fetch-cached-dns@2.1.2

Updated on Sep 21, 2022

6.1.1

Updated on Jun 05, 2021

6.1.0

Updated on Oct 16, 2020

6.0.0

Updated on Mar 03, 2020

5.2.0

Updated on Jan 02, 2020

View All 15 releases

Contributors

Unable to fetch Contributors

View All 88 Contributors

Languages

JavaScript

Shell

JavaScript (99.68%)

Shell (0.32%)

validate.email 🚀

Verify real, reachable, and deliverable emails with instant MX records, SMTP checks, and disposable email detection.

Developer

vercel

Download Statistics

Total Downloads

28,715,650

Last Day

134,377

Last Week

671,236

Last Month

2,654,280

Last Year

13,635,327

GitHub Statistics

572 Stars

201 Commits

26 Forks

60 Watchers

1 Branches

88 Contributors

Updated on Jan 21, 2025

Bundle Size

11.16 kB

Minified

4.16 kB

Minified + Gzipped

Bundlephobia

Maintainers

104

Package Meta Information

Latest Version

5.1.3

Package Id

@vercel/fetch-retry@5.1.3

Unpacked Size

12.39 kB

Size

4.23 kB

File Count

Total Downloads

Cumulative downloads

Total Downloads

28,715,650

Last Day

48.8%

134,377

Compared to previous day

Last Week

15.7%

671,236

Compared to previous week

Last Month

66.9%

2,654,280

Compared to previous month

Last Year

154.6%

13,635,327

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

@vercel/fetch-retry

A layer on top of fetch (via node-fetch) with sensible defaults for retrying to prevent common errors.

How to use

fetch-retry is a drop-in replacement for fetch:

1const fetch = require('@vercel/fetch-retry')(require('node-fetch'))
2
3module.exports = async () => {
4  const res = await fetch('http://localhost:3000')
5  console.log(res.status);
6}

Make sure to yarn add @vercel/fetch-retry in your main package.

Note that you can pass retry options to using opts.retry. We also provide a opts.onRetry and opts.retry.maxRetryAfter options.

opts.onRetry is a customized version of opts.retry.onRetry and passes not only the error object in each retry but also the current opts object.

opts.retry.maxRetryAfter is the max wait time according to the Retry-After header. If it exceeds the option value, stop retrying and returns the error response. It defaults to 20.

Rationale

Some errors are very common in production (like the underlying Socket yielding ECONNRESET), and can easily and instantly be remediated by retrying.

The default behavior of fetch-retry is to attempt retries 10, 60 360, 2160 and 12960 milliseconds (a total of 5 retries) after a network error, 429 or 5xx error occur.

The idea is to provide a sensible default: most applications should continue to perform correctly with a worst case scenario of a given request having an additional 15550ms overhead.

On the other hand, most applications that use fetch-retry instead of vanilla fetch should see lower rates of common errors and fewer 'glitches' in production.

Tests

To run rests, execute

1npm test

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Security-Policy

Determines if the project has published a security policy.

5

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

License

Determines if the project has defined a license.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

3.3

/10

Last Scanned on 2025-02-17

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

@vercel/fetch-retry

Installations

Developer Guide

No

N/A

Score

Pull Requests

0

58

20

38

Issues

1

25

24

Releases

Contributors

Unable to fetch Contributors

Languages

validate.email 🚀

Developer

Download Statistics

GitHub Statistics

Bundle Size

11.16 kB

4.16 kB

Maintainers

Package Meta Information

Total Downloads

28,715,650

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

@vercel/fetch-retry

How to use

Rationale

Tests

10

10

10

5

0

0

0

0

0

0

0

0

0

3.3

/10