1.0.0 • Published 10 months ago

@yiiy/throttle v1.0.0

Weekly downloads
-
License
ISC
Repository
github
Last release
10 months ago

Rate Limiting Middleware for Express

A simple and efficient rate limiting middleware for Express applications, designed to help protect your API from excessive use and ensure fair usage. This package uses an in-memory store by default for tracking request counts, making it easy to integrate and use out of the box.

Features

  • Easy Integration: Seamlessly integrates with any Express application.
  • In-Memory Store: Comes with a built-in in-memory store for IP-based rate limiting.
  • Configurable Limits: Allows customization of request limits and window times.
  • Extendable: Designed to be extendable for use with external stores like Redis for distributed applications.

Usage

First, install the package using npm:

import express from 'express';
import { rateLimiter } from '@yi/throttle';

const app = express();
const PORT = 3000;

// Apply rate limiting middleware
app.use(rateLimiter({
  windowMs: 15 * 60 * 1000, // 15 minutes
  maxRequests: 100, // Limit each IP to 100 requests per windowMs
}));

app.get('/', (req, res) => {
  res.send('Hello, World!');
});

app.listen(PORT, () => {
  console.log(`Server running on http://localhost:${PORT}`);
});

API

  • rateLimiter(options): RequestHandler Creates and returns the rate limiting middleware.

Options

  • windowMs: Number of milliseconds for each rate limiting window (default: 15 minutes).
  • maxRequests: Maximum number of requests allowed per window per IP (default: 100).

License

This project is licensed under the MIT License - see the LICENSE file for details.

1.0.0

10 months ago