A cluster pool with a dynamic number of workers, but a guaranteed minimum number of workers.
This cluster pool creates new workers when the others are busy, up to the maximum number of workers.
-When the maximum number of workers is reached, an event is emitted. If you want to listen to this event, use the pool's emitter.
-
-
Template
of data sent to the worker. This can only be serializable data.
-
-
Template
of response of execution. This can only be serializable data.
+When the maximum number of workers is reached and workers are busy, an event is emitted. If you want to listen to this event, use the pool's emitter.
A cluster pool with a dynamic number of workers, but a guaranteed minimum number of workers.
This cluster pool creates new workers when the others are busy, up to the maximum number of workers. -When the maximum number of workers is reached, an event is emitted. If you want to listen to this event, use the pool's
- -emitter.Template
of data sent to the worker. This can only be serializable data.
- -Template
of response of execution. This can only be serializable data.
+When the maximum number of workers is reached and workers are busy, an event is emitted. If you want to listen to this event, use the pool'semitter.Author
Christopher Quadflieg
@@ -30,17 +28,21 @@ When the maximum number of workers is reached, an event is emitted. If you wantType Parameters
-
-
+-
-
+Data = unknown
Data = unknown
+Type of data sent to the worker. This can only be serializable data.
+Response = unknown
Response = unknown
+Type of response of execution. This can only be serializable data.
+Hierarchy
-- FixedClusterPool<Data, Response>
+
- FixedClusterPool<Data, Response>
- DynamicClusterPool
@@ -54,42 +56,36 @@ When the maximum number of workers is reached, an event is emitted. If you wantemitter?
file
Properties
Accessors
Methods
-constructor
-- new
+- new
-
-
-
Constructs a new poolifier dynamic cluster pool.
Path to an implementation of a
ClusterWorkerfile, which can be relative or absolute.
+Optionalopts: ClusterPoolOptions = {}opts: ClusterPoolOptions = {}
Options for this dynamic cluster pool.
Returns DynamicClusterPool<Data, Response>
Properties
-OptionalReadonlyemitterInherit Doc
-ReadonlyfileReadonlymaxInherit Doc
-ProtectednextId of the next message.
+Maximum number of workers that can be created by this pool.
-Readonlynumber
-Readonlyopts
-ProtectedpromiseThe promise map.
+
+ProtectedpromiseThe execution response promise map.
-
-key: This is the message Id of each submitted task.value: An object that contains the worker, the resolve function and the reject function.key: The message id of each submitted task.value: An object that contains the worker, the execution response promise resolve and reject callbacks.When we receive a message from the worker we get a map entry and resolve/reject the promise based on the message.
+When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.
-ProtectedworkerWorker choice strategy instance implementing the worker choice algorithm.
-Default to a strategy implementing a round robin algorithm.
+Worker choice strategy context referencing a worker choice algorithm implementation.
+Default to a round robin algorithm.
-ReadonlyworkersInherit Doc
-Readonlyworkers
+ReadonlyworkerInherit Doc
Accessors
Returns boolean
number
--- get numberOfRunningTasks(): number
+- Defined in src/pools/cluster/dynamic.ts:48
full
++- get full(): boolean
-
+
Inherit Doc
Returns boolean
+Privatenumber+- get numberOfQueuedTasks(): number
+-
+
Number of tasks queued in the pool.
+Returns number
+Privatenumber+- get numberOfRunningTasks(): number
+-
+
Number of tasks running in the pool.
+Returns number
type
@@ -250,32 +257,32 @@ When the maximum number of workers is reached, an event is emitted. If you want
Returns PoolType
Methods
-
+ProtectedafterProtectedafter-- after
+- after
-
-
-
-
-
-
+- Defined in src/pools/abstract-pool.ts:323
-
-- Defined in src/pools/cluster/fixed.ts:93
+
+
-
-
+- Defined in src/pools/cluster/fixed.ts:80
- Defined in src/pools/cluster/fixed.ts:75
Hook executed after the worker task promise resolution. +
Hook executed after the worker task execution. Can be overridden.
Parameters
message: MessageValue<Response, unknown>
-The received message.
+worker: Worker
+The worker.
promise: PromiseWorkerResponseWrapper<Worker, Response>
-The Promise response.
+message: MessageValue<Response, unknown>
+The received message.
Returns void
Protectedafter@@ -291,53 +298,53 @@ Can be overridden.
Returns void
+ProtectedbeforeProtectedbefore-- before
+- before
-
-
-- Defined in src/pools/abstract-pool.ts:312
+
+
-
-
-
-
-
-- Defined in src/pools/abstract-pool.ts:244
+
+
-
-
-
-
-
-
-
-- Defined in src/pools/abstract-pool.ts:237
+
+
+- Defined in src/pools/abstract-pool.ts:232
+- Defined in src/pools/cluster/fixed.ts:64
Hook executed before the worker task promise resolution. +
Hook executed before the worker task execution. Can be overridden.
Parameters
-
-
-worker: Worker
-The worker.
+workerNodeKey: number
+The worker node key.
Returns void
+ProtectedchooseProtectedchoose-- choose
+- choose
-
-
- create
-
-
- Defined in src/pools/abstract-pool.ts:418
+- Defined in src/pools/cluster/fixed.ts:88
+- Defined in src/pools/abstract-pool.ts:275
+- Defined in src/pools/cluster/fixed.ts:69
Chooses a worker for the next task.
-The default implementation uses a round robin algorithm to distribute the load.
+Chooses a worker node for the next task.
+The default uses a round robin algorithm to distribute the load.
-Returns
Worker.
+Returns
[worker node key, worker node].
Returns Worker
ProtectedcreateCreates a new worker for this pool and sets it up completely.
+Creates a new worker and sets it up completely in the pool worker nodes.
Returns
New, completely set up worker.
Returns Worker
+Protectedcreate@@ -348,7 +355,7 @@ Can be overridden.
Returns Worker
destroy
@@ -359,7 +366,7 @@ Can be overridden.
Returns Promise<void>
destroy
@@ -375,11 +382,11 @@ Can be overridden.
Returns void
execute
-- execute(data: Data): Promise<Response>
+- execute(data: Data): Promise<Response>
-
@@ -387,113 +394,31 @@ Can be overridden.
-
-
Inherit Doc
Parameters
data: Data
Returns Promise<Response>
Returns Promise<Response>
find
--- find
--
-
-
-
Inherit Doc
Returns false | Worker
get
--- get
--
-
-
-
-
-
Inherit Doc
Parameters
---
-
worker: Worker
Returns undefined | number
get
+find
-- get
+- find
-
-
-
Inherit Doc
Parameters
---
-
worker: Worker
Returns number
get
--- get
--
-
-
-
-
-
Inherit Doc
Parameters
---
-
worker: Worker
Returns undefined | number
init
--- init
--
-
-
-
Initializes tasks usage statistics.
-Parameters
---
-
worker: Worker
-The worker.
-Returns void
-Protectedinternal-- internal
--
-
-
-
Parameters
---
-
--
-
worker: Worker
messageId: number
Returns Promise<Response>
+ProtectedinternalProtectedinternal-- internal
+- internal
-
Returns boolean
Protectedis@@ -504,11 +429,11 @@ Can be overridden.
Returns boolean
register
-- register
+- register
-
@@ -523,44 +448,26 @@ Can be overridden.
-
-
-
-
Inherit Doc
worker: Worker
listener: ((message: MessageValue<Message, unknown>) => void)
+listener: ((message: MessageValue<Message, unknown>) => void)
-- (message: MessageValue<Message, unknown>): void
+- (message: MessageValue<Message, unknown>): void
-
-
-
+
Parameters
message: MessageValue<Message, unknown>
message: MessageValue<Message, unknown>
Returns void
Returns void
-Protectedremove-- remove
--
-
-
-
Removes the given worker from the pool.
-Parameters
---
-
worker: Worker
-Worker that will be removed.
-Returns void
Protectedsend-- send
+- send
-
@@ -570,15 +477,15 @@ Can be overridden.
-
-
-
Inherit Doc
worker: Worker
message: MessageValue<Data, unknown>
message: MessageValue<Data, unknown>
Returns void
+set
-- set
+- set
-
@@ -586,11 +493,11 @@ Can be overridden.
-
-
Inherit Doc
Parameters
workerChoiceStrategy: "ROUND_ROBIN" | "LESS_RECENTLY_USED" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN"
workerChoiceStrategy: "ROUND_ROBIN" | "LESS_USED" | "LESS_BUSY" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN"
Returns void
Protectedsetup@@ -601,23 +508,23 @@ Can be overridden.
Returns void
Protectedworker-- worker
+- worker
-
-
-
This function is the listener registered for each worker.
+This function is the listener registered for each worker message.
Returns
The listener function to execute when a message is received from a worker.
Returns ((message: MessageValue<Response, unknown>) => void)
+Returns ((message: MessageValue<Response, unknown>) => void)
-- (message: MessageValue<Response, unknown>): void
+- (message: MessageValue<Response, unknown>): void
-
-
-
-
This function is the listener registered for each worker.
+This function is the listener registered for each worker message.
Returns
The listener function to execute when a message is received from a worker.
Parameters
message: MessageValue<Response, unknown>
message: MessageValue<Response, unknown>
Returns void
-
+Settings
Settings
Member Visibility
Theme
Generated using TypeDoc