More…
A curated collection of promise utility packages and patterns for solving common asynchronous programming problems in JavaScript.
What is More…?
promise-fun is a curated collection of JavaScript promise utility packages and patterns created by Sindre Sorhus. It provides a wide array of small, focused modules to solve common asynchronous programming problems such as concurrency control, timing, error handling, and functional composition. The project serves as both a library of ready-to-use tools and a learning resource for effective promise-based development.
JavaScript and Node.js developers who regularly work with promises and async/await and need robust utilities for managing asynchronous operations, concurrency, error handling, and control flow.
Developers choose promise-fun because it offers a comprehensive, battle-tested set of utilities from a trusted maintainer, eliminating the need to reinvent common asynchronous patterns. Each module is small, focused, and well-documented, promoting code reuse and best practices in asynchronous JavaScript.
Overview
Promise packages, patterns, chat, and tutorials
Use Cases
Best For
- Limiting concurrency when fetching multiple API endpoints
- Implementing retry logic with exponential backoff for unreliable operations
- Debouncing or throttling async functions like search inputs
- Composing multiple async functions into a reusable pipeline
- Managing complex asynchronous control flow with conditions and loops
- Adding timeout or minimum delay guarantees to promises
Not Ideal For
- Applications with strict bundle size constraints where each additional npm package adds significant overhead
- Teams preferring a single, integrated async utility library to avoid managing dozens of micro-dependencies
- Projects already built around reactive programming paradigms like RxJS that handle async flows differently
Pros & Cons
Pros
With over 40 specialized packages like p-map for concurrency and p-retry for error handling, it addresses nearly every common promise pattern, reducing the need to reinvent the wheel.
Each package solves a specific problem without bloat, such as p-limit for concurrency limits and delay for precise timing, promoting code reusability and simplicity.
Created by Sindre Sorhus, a renowned open-source contributor, ensuring high reliability and adherence to best practices in asynchronous JavaScript.
The FAQ includes real-world scenarios, like using p-map to fetch 100 URLs with a concurrency limit of 5, providing actionable guidance for developers.
Cons
As a collection of separate npm packages, developers must install and update each utility individually, increasing maintenance complexity and potential version conflicts.
The README explicitly states 'Not accepting additions,' limiting the ecosystem's growth and potential for addressing niche use cases through external input.
Some packages like p-catch-if are based on .then/.catch chains, which the README advises avoiding, indicating they may not align with modern async/await best practices and could introduce complexity.
Frequently Asked Questions
Related Projects
Promise anti-patterns:bird: :zap: Bluebird is a full featured promise library with unmatched performance.
Highland.jsHigh-level streams library for Node.js and the browser
pifyPromisify a callback-style function
p-mapMap over promises concurrently
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.