DynamicClusterPool | poolifier

@@ -45,7 +45,7 @@ When the maximum number of workers is reached and workers are busy, an event is

DynamicClusterPool

Defined in src/pools/cluster/dynamic.ts:15

@@ -74,7 +74,6 @@ When the maximum number of workers is reached and workers are busy, an event is maxSize minSize ready -starting type utilization worker @@ -82,18 +81,22 @@ When the maximum number of workers is reached and workers are busy, an event is

Methods

afterTaskExecutionHook -afterWorkerSetup +afterWorkerNodeSetup beforeTaskExecutionHook checkDynamicPoolSize -createAndSetupDynamicWorker -createAndSetupWorker +createAndSetupDynamicWorkerNode +createAndSetupWorkerNode createWorker destroy -destroyWorker +destroyWorkerNode enableTasksQueue execute +flushTasksQueue +getWorkerInfo internalBusy isMain +registerWorkerMessageListener +sendStartupMessageToWorker sendToWorker setTasksQueueOptions setWorkerChoiceStrategy @@ -144,7 +147,7 @@ When the maximum number of workers is reached and workers are busy, an event is

Defined in src/pools/cluster/dynamic.ts:27

Properties

@@ -154,7 +157,7 @@ When the maximum number of workers is reached and workers are busy, an event is

Events that can currently be listened to:

'full': Emitted when the pool is dynamic and the number of workers created has reached the maximum size expected.
'ready': Emitted when the number of workers created in the pool has reached the maximum size expected and are ready.
'ready': Emitted when the number of workers created in the pool has reached the minimum size expected and are ready.
'busy': Emitted when the number of workers created in the pool has reached the maximum size expected and are executing at least one task.
'error': Emitted when an uncaught error occurs.
'taskError': Emitted when an error occurs while executing a task.

Defined in src/pools/abstract-pool.ts:64

`Protected` `Readonly` filePath

filePath: string

@@ -172,7 +175,7 @@ When the maximum number of workers is reached and workers are busy, an event is

Defined in src/pools/abstract-pool.ts:104

`Protected` `Readonly` max

max: number

@@ -180,7 +183,7 @@ When the maximum number of workers is reached and workers are busy, an event is

Defined in src/pools/cluster/dynamic.ts:29

`Protected` `Readonly` numberOfWorkers

numberOfWorkers: number

@@ -189,7 +192,7 @@ When the maximum number of workers is reached and workers are busy, an event is

Defined in src/pools/abstract-pool.ts:103

`Protected` `Readonly` opts

opts: ClusterPoolOptions = {}

@@ -198,11 +201,11 @@ When the maximum number of workers is reached and workers are busy, an event is

Defined in src/pools/cluster/fixed.ts:47

`Protected` promiseResponseMap

promiseResponseMap: Map<string, PromiseResponseWrapper<Worker, Response>> = ...

The execution response promise map.

promiseResponseMap: Map<string, PromiseResponseWrapper<Response>> = ...

The task execution response promise map.

key: The message id of each submitted task.
value: An object that contains the worker, the execution response promise resolve and reject callbacks.

Defined in src/pools/abstract-pool.ts:74

`Protected` workerChoiceStrategyContext

workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

@@ -221,7 +224,7 @@ When the maximum number of workers is reached and workers are busy, an event is

Defined in src/pools/abstract-pool.ts:80

`Readonly` workerNodes

workerNodes: IWorkerNode<Worker, Data>[] = []

@@ -230,7 +233,7 @@ When the maximum number of workers is reached and workers are busy, an event is

Defined in src/pools/abstract-pool.ts:61

Accessors

@@ -245,7 +248,7 @@ When the maximum number of workers is reached and workers are busy, an event is

Defined in src/pools/cluster/dynamic.ts:48

`Protected` full

Defined in src/pools/abstract-pool.ts:602

info

Defined in src/pools/abstract-pool.ts:301

`Protected` maxSize

get maxSize(): number
-
Pool maximum size.
+
The pool maximum size.

Returns number
Overrides FixedClusterPool.maxSize
- Defined in src/pools/cluster/dynamic.ts:43

Defined in src/pools/cluster/dynamic.ts:43

`Protected` minSize

get minSize(): number
-
Pool minimum size.
+
The pool minimum size.

Returns number
Inherited from FixedClusterPool.minSize
- Defined in src/pools/cluster/fixed.ts:92

Defined in src/pools/cluster/fixed.ts:120

`Private` ready

get ready(): boolean
-
Returns boolean
+
The pool readiness boolean status.
+
+
Returns boolean
+
Inherited from FixedClusterPool.ready
- Defined in src/pools/abstract-pool.ts:405

`Private` starting

get starting(): boolean
-
Returns boolean
-
Inherited from FixedClusterPool.starting
-
- Defined in src/pools/abstract-pool.ts:398

Defined in src/pools/abstract-pool.ts:440

`Protected` type

get type(): "fixed" | "dynamic"
-
Pool type.
+
The pool type.

If it is 'dynamic', it provides the max property.

Returns "fixed" | "dynamic"
Overrides FixedClusterPool.type
- Defined in src/pools/cluster/dynamic.ts:38

Defined in src/pools/cluster/dynamic.ts:38

`Private` utilization

get utilization(): number
-
Gets the approximate pool utilization.
+
The approximate pool utilization.

Returns number
The pool utilization.
Inherited from FixedClusterPool.utilization
- Defined in src/pools/abstract-pool.ts:416

Defined in src/pools/abstract-pool.ts:457

`Protected` worker

get worker(): "cluster" | "thread"
-
Gets the worker type.
+
The worker type.

Returns "cluster" | "thread"
Inherited from FixedClusterPool.worker
- Defined in src/pools/cluster/fixed.ts:87

Defined in src/pools/cluster/fixed.ts:115

Methods

`Protected` afterTaskExecutionHook

afterTaskExecutionHook(worker, message): void
afterTaskExecutionHook(workerNodeKey, message): void
Hook executed after the worker task execution. Can be overridden.
@@ -365,8 +362,8 @@ Can be overridden.

Parameters
- -
  worker: Worker
  -
  The worker.
  +
  workerNodeKey: number
  +
  The worker node key.
- @@ -378,28 +375,28 @@ Can be overridden.
  Inherited from FixedClusterPool.afterTaskExecutionHook
  - Defined in src/pools/abstract-pool.ts:663

`Protected` afterWorkerSetup

Defined in src/pools/abstract-pool.ts:718

`Protected` afterWorkerNodeSetup

afterWorkerSetup(worker): void
afterWorkerNodeSetup(workerNodeKey): void
-
Function that can be hooked up when a worker has been newly created and moved to the pool worker nodes. +
Method hooked up after a worker node has been newly created. Can be overridden.
Parameters
- -
  worker: Worker
  -
  The newly created worker.
  +
  workerNodeKey: number
  +
  The newly created worker node key.
Returns void
-
Inherited from FixedClusterPool.afterWorkerSetup
+
Inherited from FixedClusterPool.afterWorkerNodeSetup
- Defined in src/pools/abstract-pool.ts:891

Defined in src/pools/abstract-pool.ts:947

`Protected` beforeTaskExecutionHook

Defined in src/pools/abstract-pool.ts:697

`Protected` checkDynamicPoolSize

Returns void

`Protected` createAndSetupDynamicWorker

Defined in src/pools/abstract-pool.ts:173

`Protected` createAndSetupDynamicWorkerNode

createAndSetupDynamicWorker(): Worker
createAndSetupDynamicWorkerNode(): number
-
Creates a new dynamic worker and sets it up completely in the pool worker nodes.
+
Creates a new, completely set up dynamic worker node.

-
Returns Worker
New, completely set up dynamic worker.
+
Returns number
New, completely set up dynamic worker node key.
-
Inherited from FixedClusterPool.createAndSetupDynamicWorker
+
Inherited from FixedClusterPool.createAndSetupDynamicWorkerNode
- Defined in src/pools/abstract-pool.ts:974

`Protected` createAndSetupWorker

Defined in src/pools/abstract-pool.ts:896

`Protected` createAndSetupWorkerNode

createAndSetupWorker(): Worker
createAndSetupWorkerNode(): number
-
Creates a new worker and sets it up completely in the pool worker nodes.
+
Creates a new, completely set up worker node.

-
Returns Worker
New, completely set up worker.
+
Returns number
New, completely set up worker node key.
-
Inherited from FixedClusterPool.createAndSetupWorker
+
Inherited from FixedClusterPool.createAndSetupWorkerNode
- Defined in src/pools/abstract-pool.ts:908

Defined in src/pools/abstract-pool.ts:856

`Protected` createWorker

Defined in src/pools/cluster/fixed.ts:105

destroy

destroy(): Promise<void>
-
Terminates every current worker in this pool.
+
Terminates all workers in this pool.

Returns Promise<void>
Inherited from FixedClusterPool.destroy
- Defined in src/pools/abstract-pool.ts:602

`Protected` destroyWorker

Defined in src/pools/abstract-pool.ts:660

`Protected` destroyWorkerNode

destroyWorker(worker): void
destroyWorkerNode(workerNodeKey): Promise<void>
-
Terminates the given worker.
+
Terminates the worker node given its worker node key.
Parameters
- -
  worker: Worker
  -
  A worker within workerNodes.
  +
  workerNodeKey: number
  +
  The worker node key.
-
Returns void
+
Returns Promise<void>
-
Inherited from FixedClusterPool.destroyWorker
+
Inherited from FixedClusterPool.destroyWorkerNode
- Defined in src/pools/cluster/fixed.ts:63

Defined in src/pools/cluster/fixed.ts:63

enableTasksQueue

Defined in src/pools/abstract-pool.ts:567

execute

Defined in src/pools/abstract-pool.ts:628

`Protected` flushTasksQueue

flushTasksQueue(workerNodeKey): void
+
+
Parameters
+
- +
  workerNodeKey: number
+
Returns void
+
Inherited from FixedClusterPool.flushTasksQueue
+
- Defined in src/pools/abstract-pool.ts:1157

`Protected` getWorkerInfo

getWorkerInfo(workerNodeKey): WorkerInfo
+
Gets the worker information given its worker node key.
+
+
+
Parameters
+
- +
  workerNodeKey: number
  +
  The worker node key.
  +
  +
+
Returns WorkerInfo
The worker information.
+ +
+
Inherited from FixedClusterPool.getWorkerInfo
+
- Defined in src/pools/abstract-pool.ts:1096

`Protected` internalBusy

Defined in src/pools/abstract-pool.ts:618

`Protected` isMain

Defined in src/pools/cluster/fixed.ts:58

`Protected` registerWorkerMessageListener

registerWorkerMessageListener<Message>(workerNodeKey, listener): void
+
Registers a listener callback on the worker given its worker node key.
+
+
+
Type Parameters
+
- +
  Message
+
+
Parameters
+
- +
  workerNodeKey: number
  +
  The worker node key.
  +
  +
- +
  listener: ((message) => void)
  +
  The message listener callback.
  +
  +
  +
  - +
    - (message): void
    - +
      +
      Parameters
      +
      +
      +
      message: MessageValue<Message, unknown>
      +
      Returns void
+
Returns void
+
+
Inherited from FixedClusterPool.registerWorkerMessageListener
+
- Defined in src/pools/cluster/fixed.ts:97

`Protected` sendStartupMessageToWorker

sendStartupMessageToWorker(workerNodeKey): void
+
Sends the startup message to worker given its worker node key.
+
+
+
Parameters
+
- +
  workerNodeKey: number
  +
  The worker node key.
  +
  +
+
Returns void
+
+
Inherited from FixedClusterPool.sendStartupMessageToWorker
+
- Defined in src/pools/cluster/fixed.ts:89

`Protected` sendToWorker

sendToWorker(worker, message): void
sendToWorker(workerNodeKey, message): void
-
Sends a message to the given worker.
+
Sends a message to worker given its worker node key.
Parameters
- -
  worker: Worker
  -
  The worker which should receive the message.
  +
  workerNodeKey: number
  +
  The worker node key.
- @@ -613,7 +706,7 @@ Can be overridden.
  Inherited from FixedClusterPool.sendToWorker
  
  -
  Defined in src/pools/cluster/fixed.ts:72

Defined in src/pools/cluster/fixed.ts:81

`Protected` workerListener

workerListener(): ((message) => void)
-
This function is the listener registered for each worker message.
+
This method is the listener registered for each worker message.

Returns ((message) => void)
The listener function to execute when a message is received from a worker.
@@ -706,7 +799,7 @@ Can be overridden.
- (message): void
- -
  This function is the listener registered for each worker message.
  +
  This method is the listener registered for each worker message.
  Parameters
  @@ -719,7 +812,7 @@ Can be overridden.
  
  Inherited from FixedClusterPool.workerListener
  
  -
  Defined in src/pools/abstract-pool.ts:1001

worker: Worker

workerNodeKey: number

worker: Worker

workerNodeKey: number

worker: Worker

workerNodeKey: number

Parameters

message: MessageValue<Message, unknown>

Returns void

worker: Worker

workerNodeKey: number

Parameters