DynamicThreadPool | poolifier

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

DynamicThreadPool

Defined in src/pools/thread/dynamic.ts:16

Index

Constructors

constructor +

constructor

Properties

emitter? +

emitter? filePath max numberOfWorkers @@ -68,7 +68,7 @@ When the maximum number of threads is reached and workers are busy, an event is

Accessors

busy +

busy full info maxSize @@ -80,37 +80,44 @@ When the maximum number of threads is reached and workers are busy, an event is

Constructors

constructor

new DynamicThreadPool<Data, Response>(min, max, filePath, opts?): DynamicThreadPool<Data, Response>
@@ -150,28 +157,29 @@ When the maximum number of threads is reached and workers are busy, an event is
Overrides FixedThreadPool.constructor
- Defined in src/pools/thread/dynamic.ts:27

Defined in src/pools/thread/dynamic.ts:28

Properties

`Optional` `Readonly` emitter

emitter?: PoolEmitter

Emitter on which events can be listened to.

`Optional` emitter

emitter?: EventEmitterAsyncResource

Event emitter integrated with async resource on which events can be listened to. +The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

Events that can currently be listened to:

'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.
'busy': Emitted when the number of workers created in the pool has reached the maximum size expected and are executing concurrently their tasks quota.
'full': Emitted when the pool is dynamic and the number of workers created has reached the maximum size expected.
'destroy': Emitted when the pool is destroyed.
'destroy': Emitted when the pool is destroyed.
'error': Emitted when an uncaught error occurs.
'taskError': Emitted when an error occurs while executing a task.
'backPressure': Emitted when all worker nodes have back pressure (i.e. their tasks queue is full: queue size >= pool maximum size^2).
'backPressure': Emitted when all worker nodes have back pressure (i.e. their tasks queue is full: queue size >= maximum queue size).

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

`Protected` `Readonly` filePath

filePath: string

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

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

`Protected` `Readonly` max

max: number

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

Defined in src/pools/thread/dynamic.ts:30

`Protected` `Readonly` numberOfWorkers

numberOfWorkers: number

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

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

`Protected` `Readonly` opts

opts: ThreadPoolOptions = {}

@@ -207,11 +215,11 @@ When the maximum number of threads is reached and workers are busy, an event is

Defined in src/pools/thread/fixed.ts:49

`Protected` promiseResponseMap

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

The task execution response promise map.

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:88

`Protected` workerChoiceStrategyContext

workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

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

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

`Readonly` `Internal` workerNodes

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

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

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

Accessors

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

Defined in src/pools/thread/dynamic.ts:44

Methods

addTaskFunction

addTaskFunction(name, fn): Promise<boolean>
+
Adds a task function to this pool. +If a task function with the same name already exists, it will be overwritten.
+
+
+
Parameters
+
- +
  name: string
  +
  The name of the task function.
  +
  +
- +
  fn: TaskFunction<Data, Response>
  +
  The task function.
  +
  +
+
Returns Promise<boolean>
true if the task function was added, false otherwise.
+ +
+
Throws
https://nodejs.org/api/errors.html#class-typeerror If the name parameter is not a string or an empty string.
+ +
Throws
https://nodejs.org/api/errors.html#class-typeerror If the fn parameter is not a function.
+
+
Inherited from FixedThreadPool.addTaskFunction
+
- Defined in src/pools/abstract-pool.ts:807

`Protected` afterTaskExecutionHook

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

`Protected` afterWorkerNodeSetup

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

`Protected` beforeTaskExecutionHook

`Protected` checkDynamicPoolSize

checkDynamicPoolSize(min, max): void
-
-
Parameters
-
- -
  min: number
- -
  max: number
-
Returns void
-
Inherited from FixedThreadPool.checkDynamicPoolSize
-
- Defined in src/pools/abstract-pool.ts:179

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

`Protected` createAndSetupDynamicWorkerNode

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

`Protected` createAndSetupWorkerNode

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

`Protected` createWorker

Defined in src/pools/thread/fixed.ts:137

`Protected` deregisterWorkerMessageListener

deregisterWorkerMessageListener<Message>(workerNodeKey, listener): void
+
Deregisters 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 FixedThreadPool.deregisterWorkerMessageListener
+
- Defined in src/pools/thread/fixed.ts:127

destroy

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

`Protected` destroyWorkerNode

Defined in src/pools/thread/fixed.ts:60

enableTasksQueue

enableTasksQueue(enable, tasksQueueOptions?): void
-
Enables/disables the worker tasks queue in this pool.
+
Enables/disables the worker node tasks queue in this pool.
Parameters
- enable: boolean
  -
  Whether to enable or disable the worker tasks queue.
  +
  Whether to enable or disable the worker node tasks queue.
- Optional tasksQueueOptions: TasksQueueOptions
  -
  The worker tasks queue options.
  +
  The worker node tasks queue options.
Returns void
Inherited from FixedThreadPool.enableTasksQueue
- Defined in src/pools/abstract-pool.ts:606

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

execute

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

`Protected` flagWorkerNodeAsNotReady

flagWorkerNodeAsNotReady(workerNodeKey): void
+
+
Parameters
+
- +
  workerNodeKey: number
+
Returns void
+
Inherited from FixedThreadPool.flagWorkerNodeAsNotReady
+
- Defined in src/pools/abstract-pool.ts:1646

`Protected` flushTasksQueue

Returns void

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

`Protected` getWorkerInfo

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

hasTaskFunction

hasTaskFunction(name): boolean
+
Whether the specified task function exists in this pool.
+
+
+
Parameters
+
- +
  name: string
  +
  The name of the task function.
  +
  +
+
Returns boolean
true if the task function exists, false otherwise.
+ +
+
Inherited from FixedThreadPool.hasTaskFunction
+
- Defined in src/pools/abstract-pool.ts:794

hasWorkerNodeBackPressure

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

`Protected` internalBusy

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

`Protected` isMain

listTaskFunctions

Defined in src/pools/thread/fixed.ts:55

listTaskFunctionNames

listTaskFunctions(): string[]
listTaskFunctionNames(): string[]
Lists the names of task function available in this pool.

Returns string[]
The names of task function available in this pool.
-
Inherited from FixedThreadPool.listTaskFunctions
+
Inherited from FixedThreadPool.listTaskFunctionNames
+
- Defined in src/pools/abstract-pool.ts:846

`Protected` registerOnceWorkerMessageListener

registerOnceWorkerMessageListener<Message>(workerNodeKey, listener): void
+
Registers once 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 FixedThreadPool.registerOnceWorkerMessageListener
- Defined in src/pools/abstract-pool.ts:678

Defined in src/pools/thread/fixed.ts:117

`Protected` registerWorkerMessageListener

Defined in src/pools/thread/fixed.ts:107

removeTaskFunction

removeTaskFunction(name): Promise<boolean>
+
Removes a task function from this pool.
+
+
+
Parameters
+
- +
  name: string
  +
  The name of the task function.
  +
  +
+
Returns Promise<boolean>
true if the task function was removed, false otherwise.
+ +
+
Inherited from FixedThreadPool.removeTaskFunction
+
- Defined in src/pools/abstract-pool.ts:830

`Protected` sendKillMessageToWorker

sendKillMessageToWorker(workerNodeKey, workerId): Promise<void>
sendKillMessageToWorker(workerNodeKey): Promise<void>
Parameters
- -
  workerNodeKey: number
- -
  workerId: number
+
workerNodeKey: number

Returns Promise<void>

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

`Protected` sendStartupMessageToWorker

Defined in src/pools/thread/fixed.ts:92

`Protected` sendToWorker

Defined in src/pools/thread/fixed.ts:78

setDefaultTaskFunction

setDefaultTaskFunction(name): Promise<boolean>
+
Sets the default task function in this pool.
+
+
+
Parameters
+
- +
  name: string
  +
  The name of the task function.
  +
  +
+
Returns Promise<boolean>
true if the default task function was set, false otherwise.
+ +
+
Inherited from FixedThreadPool.setDefaultTaskFunction
+
- Defined in src/pools/abstract-pool.ts:859

setTasksQueueOptions

setTasksQueueOptions(tasksQueueOptions): void
-
Sets the worker tasks queue options in this pool.
+
Sets the worker node tasks queue options in this pool.
Parameters
- tasksQueueOptions: TasksQueueOptions
  -
  The worker tasks queue options.
  +
  The worker node tasks queue options.
Returns void
Inherited from FixedThreadPool.setTasksQueueOptions
- Defined in src/pools/abstract-pool.ts:618

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

setWorkerChoiceStrategy

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

setWorkerChoiceStrategyOptions

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

`Protected` setupHook

`Protected` workerListener

workerListener(): ((message) => void)
Defined in src/pools/abstract-pool.ts:998

start

start(): void
-
This method is the listener registered for each worker message.
+
Starts the minimum number of workers in this pool.

-
Returns ((message) => void)
The listener function to execute when a message is received from a worker.
- -
- -
  - (message): void

`Protected` workerMessageListener

workerMessageListener(message): void
-
This method is the listener registered for each worker message.
+
This method is the message listener registered on each worker.
Parameters
- message: MessageValue<Response, unknown>
-
Returns void
The listener function to execute when a message is received from a worker.
- -

Index

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

constructor

Properties

Optional Readonly emitter

Optional emitter

Protected Readonly filePath

Protected Readonly max

Protected Readonly numberOfWorkers

Protected Readonly opts

Protected promiseResponseMap

Protected workerChoiceStrategyContext

Readonly Internal workerNodes

Accessors

Protected full

info

Protected maxSize

Protected minSize

Private ready

Protected type

Private utilization

Protected worker

Methods

addTaskFunction

Parameters

name: string

fn: TaskFunction<Data, Response>

Returns Promise<boolean>

Throws

Throws

Protected afterTaskExecutionHook

Protected afterWorkerNodeSetup

Protected beforeTaskExecutionHook

Protected checkDynamicPoolSize

Parameters

min: number

max: number

Returns void

Protected createAndSetupDynamicWorkerNode

Protected createAndSetupWorkerNode

Protected createWorker

Protected deregisterWorkerMessageListener

Type Parameters

Message

Parameters

workerNodeKey: number

listener: ((message) => void)

Parameters

message: MessageValue<Message, unknown>

Returns void

Returns void

destroy

Protected destroyWorkerNode

enableTasksQueue

Parameters

enable: boolean

Optional tasksQueueOptions: TasksQueueOptions

Returns void

execute

Protected flagWorkerNodeAsNotReady

Parameters

workerNodeKey: number

Returns void

Protected flushTasksQueue

Returns void

Protected getWorkerInfo

hasTaskFunction

Parameters

name: string

Returns boolean

hasWorkerNodeBackPressure

Protected internalBusy

Protected isMain

listTaskFunctions

`Optional` `Readonly` emitter

`Optional` emitter

`Protected` `Readonly` filePath

`Protected` `Readonly` max

`Protected` `Readonly` numberOfWorkers

`Protected` `Readonly` opts

`Protected` promiseResponseMap

`Protected` workerChoiceStrategyContext

`Readonly` `Internal` workerNodes

`Protected` full

`Protected` maxSize

`Protected` minSize

`Private` ready

`Protected` type

`Private` utilization

`Protected` worker

`Protected` afterTaskExecutionHook

`Protected` afterWorkerNodeSetup

`Protected` beforeTaskExecutionHook

`Protected` checkDynamicPoolSize

`Protected` createAndSetupDynamicWorkerNode

`Protected` createAndSetupWorkerNode

`Protected` createWorker

`Protected` deregisterWorkerMessageListener

`Protected` destroyWorkerNode

`Optional` tasksQueueOptions: TasksQueueOptions

`Protected` flagWorkerNodeAsNotReady

`Protected` flushTasksQueue

`Protected` getWorkerInfo

`Protected` internalBusy

`Protected` isMain

`Protected` registerOnceWorkerMessageListener

`Protected` registerWorkerMessageListener

`Protected` sendKillMessageToWorker

`Protected` sendStartupMessageToWorker

`Protected` sendToWorker

`Protected` setupHook

`Protected` workerListener

`Protected` workerMessageListener