IPool | poolifier

Properties

destroy

`Readonly` destroy

destroy: (() => Promise<void>)

Type declaration

@@ -72,25 +79,32 @@

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

-
Returns Promise<void>

Defined in src/pools/pool.ts:262

`Optional` `Readonly` emitter

emitter?: PoolEmitter

Emitter on which events can be listened to.

Events that can currently be listened to:

'full': Emitted when the pool is dynamic and full.
'busy': Emitted when the pool is busy.
'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 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.
'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 >= maximum queue size).

enableTasksQueue

`Readonly` enableTasksQueue

enableTasksQueue: ((enable, tasksQueueOptions?) => void)

Type declaration

@@ -99,76 +113,143 @@

(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.
  -
- Optional tasksQueueOptions: TasksQueueOptions
  -
  The worker tasks queue options.
  -
-
Returns void

execute

execute: ((data?) => Promise<Response>)

`Readonly` execute

execute: ((data?, name?, transferList?) => Promise<Response>)

Type declaration

- (data?): Promise<Response>
- (data?, name?, transferList?): Promise<Response>
- -
  Executes the function specified in the worker constructor with the task data input parameter.
  +
  Executes the specified function in the worker constructor with the task data input parameter.
  Parameters
  - Optional data: Data
    -
    The task input data for the specified worker function. This can only be serializable data.
    -
  +
  The optional task input data for the specified task function. This can only be structured-cloneable data.
  +
  +
- +
  Optional name: string
  +
  The optional name of the task function to execute. If not specified, the default task function will be executed.
  +
  +
- +
  Optional transferList: TransferListItem[]
  +
  An optional array of transferable objects to transfer ownership of. Ownership of the transferred objects is given to the pool's worker_threads worker and they should not be used in the main thread afterwards.
  +
  +

Returns Promise<Response>

Promise that will be fulfilled when the task is completed.

`Readonly` hasWorkerNodeBackPressure

hasWorkerNodeBackPressure: ((workerNodeKey) => boolean)

Type declaration

+
- (workerNodeKey): boolean
- Internal +
  Whether the worker node has back pressure (i.e. its tasks queue is full).
  +
  +
  +
  Parameters
  +
  - +
    workerNodeKey: number
    +
    The worker node key.
    +
    +
  +
  Returns boolean
  true if the worker node has back pressure, false otherwise.
  + +

`Readonly` info

info: PoolInfo

Pool information.

`Readonly` listTaskFunctions

listTaskFunctions: (() => string[])

Type declaration

+
- (): string[]
- +
  Lists the names of task function available in this pool.
  +
  +
  Returns string[]
  The names of task function available in this pool.
  + +

setTasksQueueOptions

`Readonly` setTasksQueueOptions

setTasksQueueOptions: ((tasksQueueOptions) => void)

Type declaration

- (tasksQueueOptions): void
- (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.
    -
  -
  Returns void

setWorkerChoiceStrategy

`Readonly` setWorkerChoiceStrategy

setWorkerChoiceStrategy: ((workerChoiceStrategy, workerChoiceStrategyOptions?) => void)

Type declaration

- (workerChoiceStrategy, workerChoiceStrategyOptions?): void
- (workerChoiceStrategy, workerChoiceStrategyOptions?): void
- Sets the worker choice strategy in this pool.
  
  @@ -176,25 +257,28 @@
  Parameters
  - -
    workerChoiceStrategy: "ROUND_ROBIN" | "LESS_USED" | "LESS_BUSY" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN"
    +
    workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
    
    The worker choice strategy.
    -

`Optional` workerChoiceStrategyOptions: WorkerChoiceStrategyOptions

The worker choice strategy options.

Returns void

setWorkerChoiceStrategyOptions

`Readonly` setWorkerChoiceStrategyOptions

setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions) => void)

Type declaration

- (workerChoiceStrategyOptions): void
- (workerChoiceStrategyOptions): void
- Sets the worker choice strategy options in this pool.
  
  @@ -204,98 +288,92 @@
- workerChoiceStrategyOptions: WorkerChoiceStrategyOptions
  
  The worker choice strategy options.
  -

Returns void

`Readonly` type

type: PoolType

Pool type.

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

`Readonly` start

start: (() => void)

Type declaration

+
- (): void
- +
  Starts the minimum number of workers in this pool.
  +
  +
  Returns void
  +

`Readonly` workerNodes

workerNodes: WorkerNode<Worker, Data>[]

`Readonly` `Internal` workerNodes

workerNodes: IWorkerNode<Worker, Data>[]

Pool worker nodes.

Interface IPool<Worker, Data, Response>

Type Parameters

Worker extends IWorker

Data = unknown

Response = unknown

Hierarchy

Index

Index

Properties

Properties

destroy

Readonly destroy

Type declaration

Returns Promise<void>

Optional Readonly emitter

Optional Readonly emitter

enableTasksQueue

Readonly enableTasksQueue

Type declaration

Parameters

enable: boolean

Optional tasksQueueOptions: TasksQueueOptions

Returns void

execute

Readonly execute

Type declaration

Parameters

Optional data: Data

Optional name: string

Optional transferList: TransferListItem[]

Returns Promise<Response>

Readonly hasWorkerNodeBackPressure

Type declaration

Parameters

workerNodeKey: number

Returns boolean

Readonly info

Readonly listTaskFunctions

Type declaration

Returns string[]

setTasksQueueOptions

Readonly setTasksQueueOptions

Type declaration

Parameters

tasksQueueOptions: TasksQueueOptions

Returns void

setWorkerChoiceStrategy

Readonly setWorkerChoiceStrategy

Type declaration

Parameters

workerChoiceStrategy: "ROUND_ROBIN" | "LESS_USED" | "LESS_BUSY" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN"

workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

Optional workerChoiceStrategyOptions: WorkerChoiceStrategyOptions

Returns void

setWorkerChoiceStrategyOptions

Readonly setWorkerChoiceStrategyOptions

Type declaration

workerChoiceStrategyOptions: WorkerChoiceStrategyOptions

Returns void

Readonly type

Readonly start

Type declaration

Returns void

Readonly workerNodes

Readonly Internal workerNodes

Settings

Settings

Member Visibility

Theme

On This Page

On This Page

`Readonly` destroy

`Optional` `Readonly` emitter

`Optional` `Readonly` emitter

`Readonly` enableTasksQueue

`Optional` tasksQueueOptions: TasksQueueOptions

`Readonly` execute

`Optional` data: Data

`Optional` name: string

`Optional` transferList: TransferListItem[]

`Readonly` hasWorkerNodeBackPressure

`Readonly` info

`Readonly` listTaskFunctions

`Readonly` setTasksQueueOptions

`Readonly` setWorkerChoiceStrategy

`Optional` workerChoiceStrategyOptions: WorkerChoiceStrategyOptions

`Readonly` setWorkerChoiceStrategyOptions

`Readonly` type

`Readonly` start

`Readonly` workerNodes

`Readonly` `Internal` workerNodes