https://github.com/ofershap/tiny-map
Map over promises with concurrency control. Drop-in p-map replacement. ESM + CJS, zero deps, TypeScript.
https://github.com/ofershap/tiny-map
Last synced: 3 months ago
JSON representation
Map over promises with concurrency control. Drop-in p-map replacement. ESM + CJS, zero deps, TypeScript.
- Host: GitHub
- URL: https://github.com/ofershap/tiny-map
- Owner: ofershap
- License: mit
- Created: 2026-03-05T19:21:48.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-12T18:18:22.000Z (3 months ago)
- Last Synced: 2026-03-13T00:28:57.342Z (3 months ago)
- Language: TypeScript
- Size: 760 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# tiny-map
[](https://www.npmjs.com/package/tiny-pmap)
[](https://www.npmjs.com/package/tiny-pmap)
[](https://github.com/ofershap/tiny-map/actions/workflows/ci.yml)
[](https://www.typescriptlang.org/)
[](https://opensource.org/licenses/MIT)
Map over promises with concurrency control. Same API as [`p-map`](https://github.com/sindresorhus/p-map), but ships both ESM and CJS with zero dependencies.
```ts
import { pMap } from "tiny-pmap";
const pages = await pMap(urls, (url) => fetch(url).then((r) => r.text()), {
concurrency: 5,
});
```
> ~1.2 KB gzipped. Zero dependencies. Replaces p-map without the ESM-only headache.
Demo built with remotion-readme-kit
## Install
```bash
npm install tiny-pmap
```
## Usage
```ts
import { pMap } from "tiny-pmap";
const users = await pMap([1, 2, 3, 4, 5], (id) => fetchUser(id), {
concurrency: 3,
});
```
### Skip items from results
```ts
import { pMap, pMapSkip } from "tiny-pmap";
const adults = await pMap(users, (user) => {
if (user.age < 18) return new pMapSkip();
return user;
});
```
### Async iterables
```ts
async function* generateIds() {
for (let i = 0; i < 100; i++) yield i;
}
const results = await pMap(generateIds(), (id) => process(id), {
concurrency: 10,
});
```
### Collect all errors
```ts
try {
await pMap(items, riskyOperation, { stopOnError: false, concurrency: 5 });
} catch (error) {
// AggregateError with all failures
console.log(error.errors);
}
```
### Cancel with AbortSignal
```ts
const controller = new AbortController();
setTimeout(() => controller.abort(), 5000);
await pMap(urls, fetchPage, {
concurrency: 3,
signal: controller.signal,
});
```
## Differences from `p-map`
`p-map` v7+ is ESM-only. If you `require("p-map")` in a CommonJS project, you get `ERR_REQUIRE_ESM`. `tiny-map` works with both `import` and `require()`.
| | `p-map` | `tiny-map` |
| ------------ | ---------------------- | ---------- |
| CJS support | v5 only (v6+ ESM-only) | ESM + CJS |
| Dependencies | none | 0 |
| TypeScript | separate @types | native |
| Export | default | named |
## Migrating from p-map
```diff
- import pMap from "p-map";
+ import { pMap } from "tiny-pmap";
```
One line. Everything else stays the same.
## API
### `pMap(input, mapper, options?)`
Maps over `input` with the `mapper` function, limiting concurrency.
- `input` - `Iterable` or `AsyncIterable`
- `mapper(element, index)` - function returning a value or promise
- `options.concurrency` - max parallel executions (default: `Infinity`)
- `options.stopOnError` - throw on first error or collect all (default: `true`)
- `options.signal` - `AbortSignal` for cancellation
Returns `Promise` with results in input order.
### `pMapSkip`
Return `new pMapSkip()` from the mapper to exclude that element from results.
## The tiny-\* family
Drop-in replacements for sindresorhus async utilities. All ship ESM + CJS with zero dependencies.
| Package | Replaces | What it does |
| ------------------------------------------------------ | -------------------- | ------------------------------ |
| [tiny-limit](https://github.com/ofershap/tiny-limit) | p-limit | Concurrency limiter |
| **tiny-map** | p-map | Concurrent map with order |
| [tiny-retry](https://github.com/ofershap/tiny-retry) | p-retry | Retry with exponential backoff |
| [tiny-queue](https://github.com/ofershap/tiny-queue) | p-queue | Priority task queue |
| [tiny-ms](https://github.com/ofershap/tiny-ms) | ms | Parse/format durations |
| [tiny-escape](https://github.com/ofershap/tiny-escape) | escape-string-regexp | Escape regex chars |
Want all async utilities in one import? Use [`tiny-pasync`](https://github.com/ofershap/tiny-async).
## Author
[](https://gitshow.dev/ofershap)
[](https://linkedin.com/in/ofershap)
[](https://github.com/ofershap)
---
If this saved you from `ERR_REQUIRE_ESM`, [star the repo](https://github.com/ofershap/tiny-map) or [open an issue](https://github.com/ofershap/tiny-map/issues) if something breaks.
---
README built with [README Builder](https://ofershap.github.io/readme-builder/)
## License
[MIT](LICENSE) © [Ofer Shapira](https://github.com/ofershap)