X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=docs%2Finterfaces%2FIPool.html;h=551e2459c9b4dd02f3b838d5ee9df371e602539c;hb=405b39c2835f645e2193dc30c3d190e3dcf3bc3e;hp=6cdc34d5284cf0f148ce0f03bbad7b9e2fef92ed;hpb=b8882b9d826a828a34eb8ba64b02a74b83db9a09;p=poolifier.git diff --git a/docs/interfaces/IPool.html b/docs/interfaces/IPool.html index 6cdc34d5..551e2459 100644 --- a/docs/interfaces/IPool.html +++ b/docs/interfaces/IPool.html @@ -1,14 +1,13 @@ -IPool | poolifier - v3.1.14

Interface IPool<Worker, Data, Response>

Contract definition for a poolifier pool.

-
interface IPool<Worker, Data, Response> {
    addTaskFunction: ((name, fn) => Promise<boolean>);
    destroy: (() => Promise<void>);
    emitter?: EventEmitterAsyncResource;
    enableTasksQueue: ((enable, tasksQueueOptions?) => void);
    execute: ((data?, name?, transferList?) => Promise<Response>);
    hasTaskFunction: ((name) => boolean);
    hasWorkerNodeBackPressure: ((workerNodeKey) => boolean);
    info: PoolInfo;
    listTaskFunctionNames: (() => string[]);
    removeTaskFunction: ((name) => Promise<boolean>);
    setDefaultTaskFunction: ((name) => Promise<boolean>);
    setTasksQueueOptions: ((tasksQueueOptions) => void);
    setWorkerChoiceStrategy: ((workerChoiceStrategy, workerChoiceStrategyOptions?) => void);
    setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions) => void);
    start: (() => void);
    workerNodes: IWorkerNode<Worker, Data>[];
}

Type Parameters

Implemented by

Properties

addTaskFunction destroy emitter? enableTasksQueue execute hasTaskFunction -hasWorkerNodeBackPressure info listTaskFunctionNames removeTaskFunction @@ -32,27 +31,28 @@ If a task function with the same name already exists, it will be overwritten.

Returns

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.

-

Readonly destroy

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

Terminates all workers in this pool.

+

Readonly destroy

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

Terminates all workers in this pool.

Type declaration

    • (): Promise<void>

    • Terminates all workers in this pool.

      -

      Returns Promise<void>

Optional Readonly emitter

emitter?: EventEmitterAsyncResource

Event emitter integrated with async resource on which events can be listened to. +

Returns Promise<void>

Optional Readonly 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.
    • +
  • 'ready': Emitted when the number of workers created in the pool has reached the minimum size expected and are ready. If the pool is dynamic with a minimum number of workers is set to zero, this event is emitted when at least one dynamic worker is 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.
    • +
  • 'empty': Emitted when the pool is dynamic with a minimum number of workers set to zero and the number of workers has reached the minimum 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).
-

Readonly enableTasksQueue

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

Enables/disables the worker node tasks queue in this pool.

+

Readonly enableTasksQueue

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

Enables/disables the worker node tasks queue in this pool.

Type declaration

    • (enable, tasksQueueOptions?): void

    • Enables/disables the worker node tasks queue in this pool.

      Parameters

      • enable: boolean

        Whether to enable or disable the worker node tasks queue.

      • Optional tasksQueueOptions: TasksQueueOptions

        The worker node tasks queue options.

      Returns void

Param: enable

Whether to enable or disable the worker node tasks queue.

Param: tasksQueueOptions

The worker node tasks queue options.

-

Readonly execute

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

Executes the specified function in the worker constructor with the task data input parameter.

+

Readonly execute

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

Executes the specified function in the worker constructor with the task data input parameter.

Type declaration

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

    • Executes the specified function in the worker constructor with the task data input parameter.

      Parameters

      • Optional data: 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.

        @@ -62,50 +62,44 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo

        Param: name

        The optional name of the task function to execute. If not specified, the default task function will be executed.

        Param: transferList

        An optional array of transferable objects to transfer ownership of. Ownership of the transferred objects is given to the chosen pool's worker_threads worker and they should not be used in the main thread afterwards.

        Returns

        Promise that will be fulfilled when the task is completed.

        -

Readonly hasTaskFunction

hasTaskFunction: ((name) => boolean)

Whether the specified task function exists in this pool.

+

Readonly hasTaskFunction

hasTaskFunction: ((name) => boolean)

Whether the specified task function exists in this pool.

Type declaration

    • (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.

Param: name

The name of the task function.

Returns

true if the task function exists, false otherwise.

-

Readonly Internal hasWorkerNodeBackPressure

hasWorkerNodeBackPressure: ((workerNodeKey) => boolean)

Whether the worker node has back pressure (i.e. its tasks queue is full).

-

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.

      -

Param: workerNodeKey

The worker node key.

-

Returns

true if the worker node has back pressure, false otherwise.

-

Readonly info

info: PoolInfo

Pool information.

-

Readonly listTaskFunctionNames

listTaskFunctionNames: (() => string[])

Lists the names of task function available in this pool.

-

Type declaration

Readonly info

info: PoolInfo

Pool information.

+

Readonly listTaskFunctionNames

listTaskFunctionNames: (() => string[])

Lists the names of task function available in this pool.

+

Type declaration

    • (): string[]

    • Lists the names of task function available in this pool.

      Returns string[]

      The names of task function available in this pool.

Returns

The names of task function available in this pool.

-

Readonly removeTaskFunction

removeTaskFunction: ((name) => Promise<boolean>)

Removes a task function from this pool.

-

Type declaration

Readonly removeTaskFunction

removeTaskFunction: ((name) => Promise<boolean>)

Removes a task function from this pool.

+

Type declaration

    • (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.

Param: name

The name of the task function.

Returns

true if the task function was removed, false otherwise.

-

Readonly setDefaultTaskFunction

setDefaultTaskFunction: ((name) => Promise<boolean>)

Sets the default task function in this pool.

-

Type declaration

Readonly setDefaultTaskFunction

setDefaultTaskFunction: ((name) => Promise<boolean>)

Sets the default task function in this pool.

+

Type declaration

    • (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.

Param: name

The name of the task function.

Returns

true if the default task function was set, false otherwise.

-

Readonly setTasksQueueOptions

setTasksQueueOptions: ((tasksQueueOptions) => void)

Sets the worker node tasks queue options in this pool.

-

Type declaration

    • (tasksQueueOptions): void

    • Sets the worker node tasks queue options in this pool.

      +

Readonly setTasksQueueOptions

setTasksQueueOptions: ((tasksQueueOptions) => void)

Sets the worker node tasks queue options in this pool.

+

Type declaration

    • (tasksQueueOptions): void

    • Sets the worker node tasks queue options in this pool.

      Parameters

      Returns void

Param: tasksQueueOptions

The worker node tasks queue options.

-

Readonly setWorkerChoiceStrategy

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

Sets the worker choice strategy in this pool.

-

Type declaration

    • (workerChoiceStrategy, workerChoiceStrategyOptions?): void

    • Sets the worker choice strategy in this pool.

      +

Readonly setWorkerChoiceStrategy

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

Sets the worker choice strategy in this pool.

+

Type declaration

    • (workerChoiceStrategy, workerChoiceStrategyOptions?): void

    • Sets the worker choice strategy in this pool.

      Parameters

      • 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

Param: workerChoiceStrategy

The worker choice strategy.

Param: workerChoiceStrategyOptions

The worker choice strategy options.

-

Readonly setWorkerChoiceStrategyOptions

setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions) => void)

Sets the worker choice strategy options in this pool.

-

Type declaration

    • (workerChoiceStrategyOptions): void

    • Sets the worker choice strategy options in this pool.

      +

Readonly setWorkerChoiceStrategyOptions

setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions) => void)

Sets the worker choice strategy options in this pool.

+

Type declaration

    • (workerChoiceStrategyOptions): void

    • Sets the worker choice strategy options in this pool.

      Parameters

      Returns void

Param: workerChoiceStrategyOptions

The worker choice strategy options.

-

Readonly start

start: (() => void)

Starts the minimum number of workers in this pool.

-

Type declaration

    • (): void

    • Starts the minimum number of workers in this pool.

      -

      Returns void

Readonly Internal workerNodes

workerNodes: IWorkerNode<Worker, Data>[]

Pool worker nodes.

-

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc

\ No newline at end of file +

Readonly start

start: (() => void)

Starts the minimum number of workers in this pool.

+

Type declaration

    • (): void

    • Starts the minimum number of workers in this pool.

      +

      Returns void

Readonly Internal workerNodes

workerNodes: IWorkerNode<Worker, Data>[]

Pool worker nodes.

+

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc

\ No newline at end of file