Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/npm/cli.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/p-limit/readme.md')
-rw-r--r--node_modules/p-limit/readme.md54
1 files changed, 43 insertions, 11 deletions
diff --git a/node_modules/p-limit/readme.md b/node_modules/p-limit/readme.md
index 90129925c..64aa476e2 100644
--- a/node_modules/p-limit/readme.md
+++ b/node_modules/p-limit/readme.md
@@ -2,14 +2,12 @@
> Run multiple promise-returning & async functions with limited concurrency
-
## Install
```
$ npm install p-limit
```
-
## Usage
```js
@@ -30,7 +28,6 @@ const input = [
})();
```
-
## API
### pLimit(concurrency)
@@ -39,14 +36,15 @@ Returns a `limit` function.
#### concurrency
-Type: `number`<br>
-Minimum: `1`
+Type: `number`\
+Minimum: `1`\
+Default: `Infinity`
Concurrency limit.
-### limit(fn)
+### limit(fn, ...args)
-Returns the promise returned by calling `fn`.
+Returns the promise returned by calling `fn(...args)`.
#### fn
@@ -54,6 +52,33 @@ Type: `Function`
Promise-returning/async function.
+#### args
+
+Any arguments to pass through to `fn`.
+
+Support for passing arguments on to the `fn` is provided in order to be able to avoid creating unnecessary closures. You probably don't need this optimization unless you're pushing a *lot* of functions.
+
+### limit.activeCount
+
+The number of promises that are currently running.
+
+### limit.pendingCount
+
+The number of promises that are waiting to run (i.e. their internal `fn` was not called yet).
+
+### limit.clearQueue()
+
+Discard pending promises that are waiting to run.
+
+This might be useful if you want to teardown the queue at the end of your program's lifecycle or discard any function calls referencing an intermediary state of your app.
+
+Note: This does not cancel promises that are already running.
+
+## FAQ
+
+### How is this different from the [`p-queue`](https://github.com/sindresorhus/p-queue) package?
+
+This package is only about limiting the number of concurrent executions, while `p-queue` is a fully featured queue implementation with lots of different options, introspection, and ability to pause the queue.
## Related
@@ -63,7 +88,14 @@ Promise-returning/async function.
- [p-all](https://github.com/sindresorhus/p-all) - Run promise-returning & async functions concurrently with optional limited concurrency
- [More…](https://github.com/sindresorhus/promise-fun)
-
-## License
-
-MIT © [Sindre Sorhus](https://sindresorhus.com)
+---
+
+<div align="center">
+ <b>
+ <a href="https://tidelift.com/subscription/pkg/npm-p-limit?utm_source=npm-p-limit&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
+ </b>
+ <br>
+ <sub>
+ Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
+ </sub>
+</div>