• Stars
    star
    1,808
  • Rank 25,590 (Top 0.6 %)
  • Language
    JavaScript
  • License
    MIT License
  • Created over 8 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Retrying made simple, easy and async

async-retry

Retrying made simple, easy, and async.

Usage

// Packages
const retry = require('async-retry');
const fetch = require('node-fetch');

await retry(
  async (bail) => {
    // if anything throws, we retry
    const res = await fetch('https://google.com');

    if (403 === res.status) {
      // don't retry upon 403
      bail(new Error('Unauthorized'));
      return;
    }

    const data = await res.text();
    return data.substr(0, 500);
  },
  {
    retries: 5,
  }
);

API

retry(retrier : Function, opts : Object) => Promise
  • The supplied function can be async or not. In other words, it can be a function that returns a Promise or a value.
  • The supplied function receives two parameters
    1. A Function you can invoke to abort the retrying (bail)
    2. A Number identifying the attempt. The absolute first attempt (before any retries) is 1.
  • The opts are passed to node-retry. Read its docs
    • retries: The maximum amount of times to retry the operation. Default is 10.
    • factor: The exponential factor to use. Default is 2.
    • minTimeout: The number of milliseconds before starting the first retry. Default is 1000.
    • maxTimeout: The maximum number of milliseconds between two retries. Default is Infinity.
    • randomize: Randomizes the timeouts by multiplying with a factor between 1 to 2. Default is true.
    • onRetry: an optional Function that is invoked after a new retry is performed. It's passed the Error that triggered it as a parameter.

Authors

More Repositories

1

next.js

The React Framework
JavaScript
125,320
star
2

hyper

A terminal built on web technologies
TypeScript
43,163
star
3

swr

React Hooks for Data Fetching
TypeScript
30,365
star
4

turborepo

Build system optimized for JavaScript and TypeScript, written in Rust
Rust
25,810
star
5

pkg

Package your Node.js project into an executable
JavaScript
24,260
star
6

vercel

Develop. Preview. Ship.
TypeScript
12,555
star
7

commerce

Next.js Commerce
TypeScript
11,004
star
8

satori

Enlightened library to convert HTML and CSS to SVG
TypeScript
10,948
star
9

micro

Asynchronous HTTP microservices
TypeScript
10,525
star
10

ai

Build AI-powered applications with React, Svelte, Vue, and Solid
TypeScript
9,618
star
11

serve

Static file serving and directory listing
TypeScript
9,208
star
12

ncc

Compile a Node.js project into a single file. Supports TypeScript, binary addons, dynamic requires.
JavaScript
9,063
star
13

styled-jsx

Full CSS support for JSX without compromises
JavaScript
7,677
star
14

ai-chatbot

A full-featured, hackable Next.js AI chatbot built by Vercel
TypeScript
6,413
star
15

nextjs-subscription-payments

Clone, deploy, and fully customize a SaaS subscription application with Next.js.
TypeScript
6,135
star
16

platforms

A full-stack Next.js app with multi-tenancy and custom domain support. Built with Next.js App Router and the Vercel Domains API.
TypeScript
5,506
star
17

ms

Tiny millisecond conversion utility
TypeScript
4,912
star
18

og-image

Open Graph Image as a Service - generate cards for Twitter, Facebook, Slack, etc
TypeScript
4,051
star
19

next-learn

Learn Next.js Starter Code
TypeScript
3,616
star
20

release

Generate changelogs with a single command
JavaScript
3,558
star
21

examples

Enjoy our curated collection of examples and solutions. Use these patterns to build your own robust and scalable applications.
TypeScript
3,466
star
22

hazel

Lightweight update server for Electron apps
JavaScript
2,896
star
23

next-plugins

Official Next.js plugins
2,677
star
24

next-app-router-playground

https://app-router.vercel.app/
TypeScript
2,509
star
25

geist-font

2,250
star
26

virtual-event-starter-kit

Open source demo that Next.js developers can clone, deploy, and fully customize for events.
TypeScript
2,131
star
27

react-tweet

Embed tweets in your React application.
TypeScript
1,569
star
28

little-date

A friendly formatter to make date ranges small & sweet
TypeScript
1,553
star
29

nft

Node.js dependency tracing utility
JavaScript
1,287
star
30

arg

Simple argument parsing
JavaScript
1,222
star
31

style-guide

Vercel's engineering style guide
JavaScript
1,209
star
32

avatar

💎 Beautiful avatars as a microservice
TypeScript
1,119
star
33

modelfusion

The TypeScript library for building AI applications.
TypeScript
1,084
star
34

nextjs-postgres-nextauth-tailwindcss-template

Admin dashboard template.
TypeScript
998
star
35

next-react-server-components

Demo repository for Next.js + React Server Components
JavaScript
980
star
36

nextjs-postgres-auth-starter

Next.js + Tailwind + Typescript + Drizzle + NextAuth + PostgreSQL starter template.
TypeScript
887
star
37

nextgram

A sample Next.js app showing dynamic routing with modals as a route.
TypeScript
867
star
38

edge-runtime

Developing, testing, and defining the runtime Web APIs for Edge infrastructure.
TypeScript
790
star
39

on-demand-isr

TypeScript
745
star
40

server-components-notes-demo

Experimental demo of React Server Components with Next.js. Deployed serverlessly on Vercel.
TypeScript
734
star
41

micro-dev

The development environment for `micro`
JavaScript
702
star
42

nextjs-portfolio-starter

Easily create a portfolio with Next.js and Markdown.
JavaScript
657
star
43

static-fun

A fun demo for wildcard domains
TypeScript
629
star
44

async-sema

Semaphore using `async` and `await`
TypeScript
624
star
45

hyperpower

Hyper particle effects extension
JavaScript
619
star
46

react-keyframes

Create frame-based animations in React
TypeScript
617
star
47

title

A service for capitalizing your title properly
JavaScript
579
star
48

fetch

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

serve-handler

The foundation of `serve`
JavaScript
564
star
50

vrs

A serverless virtual reality e-commerce experience powered by Vercel
TypeScript
517
star
51

storage

Vercel Postgres, KV, Blob, and Edge Config
TypeScript
506
star
52

fun

ƒun - Local serverless function λ development runtime
TypeScript
480
star
53

swr-site

The official website for SWR.
MDX
479
star
54

mongodb-starter

A developer directory built on Next.js and MongoDB Atlas, deployed on Vercel with the Vercel + MongoDB integration.
TypeScript
457
star
55

spr-landing

Serverless Pre-Rendering Landing Page
CSS
434
star
56

hyper-site

The official website for the Hyper terminal
JavaScript
432
star
57

pkg-fetch

A utility to fetch or build patched Node binaries used by `pkg` to generate executables. This repo hosts prebuilt binaries in Releases.
TypeScript
428
star
58

analytics

Privacy-friendly, real-time traffic insights
TypeScript
421
star
59

sveltekit-commerce

SvelteKit Commerce
Svelte
376
star
60

reactions

Next.js Incremental Static Regeneration Demo
JavaScript
308
star
61

email-prompt

CLI email prompt with autocompletion and built-in validation
JavaScript
274
star
62

uid-promise

Creates a cryptographically strong UID
TypeScript
252
star
63

fetch-retry

Wrapper around `fetch` with sensible retrying defaults
JavaScript
221
star
64

git-hooks

No nonsense Git hook management
JavaScript
202
star
65

zsh-theme

Yet another zsh theme
179
star
66

remote-cache

The Vercel Remote Cache SDK
TypeScript
174
star
67

cosmosdb-server

A Cosmos DB server implementation for testing your applications locally.
TypeScript
170
star
68

react-transition-progress

Show a progress bar while React Transitions run
TypeScript
162
star
69

update-check

Minimalistic update notifications for command line interfaces
JavaScript
159
star
70

test-listen

Quick ephemeral URLs for your tests
JavaScript
153
star
71

install-node

Simple one-liner shell script that installs official Node.js binaries
Shell
141
star
72

terraform-provider-vercel

Terraform Vercel Provider
Go
139
star
73

title-site

A website for capitalizing your titles
JavaScript
124
star
74

preview-mode-demo

This demo showcases Next.js' next-gen Static Site Generation (SSG) support.
TypeScript
110
star
75

community

Welcome to the Vercel Community. Discuss feature requests, ask questions, and connect with others in the community.
107
star
76

nextjs-discord-bot

Discord bot for the official Next.js Discord
TypeScript
105
star
77

commerce-framework

TypeScript
98
star
78

beginner-sveltekit

The complete course to start your journey building Svelte applications.
JavaScript
98
star
79

err-sh

Microservice that forwards you to error messages
JavaScript
97
star
80

webpack-asset-relocator-loader

Used in ncc while emitting and relocating any asset references
JavaScript
96
star
81

hyperyellow

Example theme for hyperterm
JavaScript
87
star
82

schemas

All schemas used for validation that are shared between our projects
JavaScript
80
star
83

opentelemetry-collector-dev-setup

Shell
72
star
84

nuxt3-kitchen-sink

An example template showing all Nuxt 3 features on Vercel.
Vue
65
star
85

next-codemod

codemod transformations to help upgrade Next.js codebases
JavaScript
63
star
86

speed-insights

Vercel Speed Insights package
TypeScript
56
star
87

ai-sdk-rag-starter

TypeScript
55
star
88

wait-for

Small utility that waits for a file to exist and optionally have some permissions set.
C
46
star
89

async-listen

Promisify server.listen for your HTTP/HTTPS/TCP server.
TypeScript
45
star
90

tracing-js

An implementation of Opentracing API for honeycomb.io
TypeScript
43
star
91

example-integration

TypeScript
42
star
92

dns-cached-resolve

Caching DNS resolver
TypeScript
41
star
93

fetch-cached-dns

A decorator on top of `fetch` that caches the DNS query
JavaScript
36
star
94

resolve-node

API endpoint to resolve an arbitrary Node.js version with semver support
JavaScript
30
star
95

remark-capitalize

Transform all markdown titles with title.sh
JavaScript
29
star
96

otel

OTEL tracing for Vercel
TypeScript
27
star
97

cra-to-next

An example of migrating Create React App to Next.js.
JavaScript
27
star
98

stripe-integration

A Vercel deploy integration to automatically set up your Stripe API keys and webhook secrets.
TypeScript
25
star
99

rcurl

`curl --resolve` helper script
Shell
23
star
100

release-auth

Handles the authentication for `release`
JavaScript
21
star