node package manager

rate-limiter-api

Rate Limiter API

A simple library to easily manage rate limits of APIs without any hassles.

Rate Limiter API image

All Contributors MIT License npm version Join the chat at https://gitter.im/abhisekp/rate-limiter-api

Table of Contents

Usage

Browser

<script src="https://cdn.rawgit.com/abhisekp/rate-limiter-api/master/dist/rate-limiter-api.js"></script>
 
<script type="text/javascript">
  var rateLimiter = RateLimiterAPI()
</script> 

NodeJS

$ {sudo -H} npm install -S rate-limiter-api
import RateLimiterAPI from 'rate-limiter-api'

Public Interface

  • rateLimiter = RateLimiterAPI({threshold: 5})
  • rateLimiter.limit(requestHandler) => Promise
    • rateLimiter.updateRateLimits on success to update rates
    • requestHandler(responseHandler) on success to continue

import RateLimiterAPI from 'rate-limiter-api'
 
const rateLimiter = RateLimiterAPI({
  threshold: 5, // leave `threshold` amount of api requests intact (minimum: 1) 
})

Pass an optional threshold value which would limit the total rate limits till the threshold is reached in the current session pulse till rate reset.


const request = rateLimiter.limit(requestHandler) //=> Promise 
 
function requestHandler(responseHandler) {
  fetch('https://api.example.com/get')
    .then((response) => {
      rateLimiter.updateRateLimits({
        rateLimit: response.headers.rateLimit,
        rateRemaining: response.headers.rateRemaining,
        rateReset: response.headers.rateReset,
      })
 
      responseHandler(null, response.body)
    })
    .catch((err) => {
      responseHandler(err)
    })
}

The limit method is passed a requestHandler which would manage the request and then call the node-style responseHandler callback (which gets passed by the RateLimiter library to the requestHandler function) after the request is successful or unsuccessful accordingly.

The request method returns a Promise.

responseHandler(Error, response)
where the first parameter is the Error object and the seconds parameter is the response.

responseHandler callback must be called to continue getting responses.

Update the rate limits i.e. {rateLimit, rateRemaining, rateReset} got from the header using updateRateLimits method.


request
  .then((response) => {
    console.dir(response, {colors:1})
  })
  .catch((error) => {
    console.error(error.message)
  })

When the request completes, the Promise resolves and can be thenable to get the response or error.

Stats

1 text file.
1 unique file.
0 files ignored.

https://github.com/AlDanial/cloc v 1.66 T=0.04 s (22.7 files/s, 2516.9 lines/s)

Language files blank comment code
JavaScript 1 12 37 62

Technologies Used

  • Babel — Transpiles modern JS to compatible and runnable JS
  • Stamp It - Composable inheritance object creation libray
  • Async JS - Utility for asynchronous functions
  • Lodash - Utility library

Help & Support

Contributors


Abhisek Pattnaik

💻 🎨 📖 💡

This project follows the all-contributors specification.

All types of Contributions are Welcome 🙏

License

MIT © Abhisek Patnaik


Tweet @abhisek
Know about/abhisekp
Chat with @abhisekp


Table of Contents ⮭
back to top ⮭