From 71218fcd1ded9a614da1fc09794a0c213ce059c9 Mon Sep 17 00:00:00 2001 From: Documentation Bot Date: Sat, 25 Nov 2023 14:17:57 +0000 Subject: [PATCH] docs: generate documentation --- docs/assets/highlight.css | 32 ++- docs/assets/search.js | 2 +- docs/classes/AbstractPool.html | 137 ++++++------- docs/classes/AbstractWorker.html | 70 +++---- docs/classes/CircularArray.html | 24 +-- docs/classes/ClusterWorker.html | 52 ++--- docs/classes/Deque.html | 28 +-- docs/classes/DynamicClusterPool.html | 100 +++++----- docs/classes/DynamicThreadPool.html | 100 +++++----- docs/classes/FixedClusterPool.html | 100 +++++----- docs/classes/FixedThreadPool.html | 100 +++++----- docs/classes/Node.html | 6 +- docs/classes/ThreadWorker.html | 54 +++--- docs/classes/WorkerChoiceStrategyContext.html | 26 +-- docs/functions/availableParallelism.html | 4 +- docs/index.html | 4 +- docs/interfaces/ClusterPoolOptions.html | 30 +-- ...tLoopUtilizationMeasurementStatistics.html | 6 +- docs/interfaces/IPool.html | 36 ++-- docs/interfaces/IWorker.html | 10 +- docs/interfaces/IWorkerChoiceStrategy.html | 18 +- docs/interfaces/IWorkerNode.html | 182 ++++++++++++++---- docs/interfaces/MeasurementOptions.html | 6 +- docs/interfaces/MeasurementStatistics.html | 16 +- .../MeasurementStatisticsRequirements.html | 10 +- docs/interfaces/MessageValue.html | 40 ++-- docs/interfaces/PoolInfo.html | 14 +- docs/interfaces/PoolOptions.html | 26 +-- docs/interfaces/PromiseResponseWrapper.html | 10 +- docs/interfaces/StrategyData.html | 6 +- docs/interfaces/StrategyPolicy.html | 8 +- docs/interfaces/Task.html | 14 +- .../TaskFunctionOperationResult.html | 6 +- docs/interfaces/TaskPerformance.html | 12 +- docs/interfaces/TaskStatistics.html | 18 +- .../TaskStatisticsRequirements.html | 10 +- docs/interfaces/TasksQueueOptions.html | 12 +- docs/interfaces/ThreadPoolOptions.html | 28 +-- .../WorkerChoiceStrategyOptions.html | 22 +-- docs/interfaces/WorkerError.html | 10 +- docs/interfaces/WorkerInfo.html | 14 +- docs/interfaces/WorkerNodeEventDetail.html | 7 +- docs/interfaces/WorkerOptions.html | 10 +- docs/interfaces/WorkerStatistics.html | 8 +- docs/interfaces/WorkerUsage.html | 12 +- docs/types/ErrorHandler.html | 4 +- docs/types/ExitHandler.html | 4 +- docs/types/KillBehavior.html | 4 +- docs/types/KillHandler.html | 4 +- docs/types/Measurement.html | 4 +- docs/types/MessageHandler.html | 4 +- docs/types/OnlineHandler.html | 4 +- docs/types/PoolEvent.html | 4 +- docs/types/PoolType.html | 4 +- docs/types/TaskAsyncFunction.html | 4 +- docs/types/TaskFunction.html | 4 +- docs/types/TaskFunctions.html | 4 +- docs/types/TaskSyncFunction.html | 4 +- docs/types/WorkerChoiceStrategy.html | 4 +- docs/types/WorkerType.html | 4 +- docs/types/Writable.html | 2 +- docs/variables/KillBehaviors.html | 4 +- docs/variables/Measurements.html | 4 +- docs/variables/PoolEvents.html | 4 +- docs/variables/PoolTypes.html | 4 +- docs/variables/WorkerChoiceStrategies.html | 4 +- docs/variables/WorkerTypes.html | 4 +- 67 files changed, 838 insertions(+), 688 deletions(-) diff --git a/docs/assets/highlight.css b/docs/assets/highlight.css index 993f6c17..9b823cb3 100644 --- a/docs/assets/highlight.css +++ b/docs/assets/highlight.css @@ -11,8 +11,16 @@ --dark-hl-4: #569CD6; --light-hl-5: #0070C1; --dark-hl-5: #4FC1FF; - --light-hl-6: #000000; - --dark-hl-6: #C8C8C8; + --light-hl-6: #AF00DB; + --dark-hl-6: #C586C0; + --light-hl-7: #A31515; + --dark-hl-7: #CE9178; + --light-hl-8: #008000; + --dark-hl-8: #6A9955; + --light-hl-9: #267F99; + --dark-hl-9: #4EC9B0; + --light-hl-10: #000000; + --dark-hl-10: #C8C8C8; --light-code-background: #FFFFFF; --dark-code-background: #1E1E1E; } @@ -25,6 +33,10 @@ --hl-4: var(--light-hl-4); --hl-5: var(--light-hl-5); --hl-6: var(--light-hl-6); + --hl-7: var(--light-hl-7); + --hl-8: var(--light-hl-8); + --hl-9: var(--light-hl-9); + --hl-10: var(--light-hl-10); --code-background: var(--light-code-background); } } @@ -36,6 +48,10 @@ --hl-4: var(--dark-hl-4); --hl-5: var(--dark-hl-5); --hl-6: var(--dark-hl-6); + --hl-7: var(--dark-hl-7); + --hl-8: var(--dark-hl-8); + --hl-9: var(--dark-hl-9); + --hl-10: var(--dark-hl-10); --code-background: var(--dark-code-background); } } @@ -47,6 +63,10 @@ --hl-4: var(--light-hl-4); --hl-5: var(--light-hl-5); --hl-6: var(--light-hl-6); + --hl-7: var(--light-hl-7); + --hl-8: var(--light-hl-8); + --hl-9: var(--light-hl-9); + --hl-10: var(--light-hl-10); --code-background: var(--light-code-background); } @@ -58,6 +78,10 @@ --hl-4: var(--dark-hl-4); --hl-5: var(--dark-hl-5); --hl-6: var(--dark-hl-6); + --hl-7: var(--dark-hl-7); + --hl-8: var(--dark-hl-8); + --hl-9: var(--dark-hl-9); + --hl-10: var(--dark-hl-10); --code-background: var(--dark-code-background); } @@ -68,4 +92,8 @@ .hl-4 { color: var(--hl-4); } .hl-5 { color: var(--hl-5); } .hl-6 { color: var(--hl-6); } +.hl-7 { color: var(--hl-7); } +.hl-8 { color: var(--hl-8); } +.hl-9 { color: var(--hl-9); } +.hl-10 { color: var(--hl-10); } pre, code { background: var(--code-background); } diff --git a/docs/assets/search.js b/docs/assets/search.js index 833511e7..fad903a9 100644 --- a/docs/assets/search.js +++ b/docs/assets/search.js @@ -1 +1 @@ -window.searchData = "data:application/octet-stream;base64,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"; \ No newline at end of file +window.searchData = "data:application/octet-stream;base64,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"; \ No newline at end of file diff --git a/docs/classes/AbstractPool.html b/docs/classes/AbstractPool.html index 5587e669..750974c0 100644 --- a/docs/classes/AbstractPool.html +++ b/docs/classes/AbstractPool.html @@ -1,8 +1,8 @@ -AbstractPool | poolifier - v3.0.7

Class AbstractPool<Worker, Data, Response>Abstract

Base class that implements some shared logic for all poolifier pools.

+AbstractPool | poolifier - v3.0.8

Class AbstractPool<Worker, Data, Response>Abstract

Base class that implements some shared logic for all poolifier pools.

Type Parameters

  • Worker extends IWorker

    Type of worker which manages this pool.

  • Data = unknown

    Type of data sent to the worker. This can only be structured-cloneable data.

  • Response = unknown

    Type of execution response. This can only be structured-cloneable data.

    -

Hierarchy

Implements

  • IPool<Worker, Data, Response>

Constructors

constructor +

Hierarchy

Implements

  • IPool<Worker, Data, Response>

Constructors

constructor

Properties

destroying emitter? filePath @@ -74,6 +74,8 @@ registerWorkerMessageListener removeTaskFunction removeWorkerNode +resetTaskSequentiallyStolenStatisticsTaskFunctionWorkerUsage +resetTaskSequentiallyStolenStatisticsWorkerUsage sendKillMessageToWorker sendStartupMessageToWorker sendStatisticsMessageToWorker @@ -97,16 +99,19 @@ unsetTasksStealingOnBackPressure updateEluWorkerUsage updateRunTimeWorkerUsage +updateTaskSequentiallyStolenStatisticsTaskFunctionWorkerUsage +updateTaskSequentiallyStolenStatisticsWorkerUsage updateTaskStatisticsWorkerUsage updateTaskStolenStatisticsWorkerUsage updateWaitTimeWorkerUsage workerMessageListener +workerNodeStealTask

Constructors

constructor

  • Constructs a new poolifier pool.

    Type Parameters

    • Worker extends IWorker

    • Data = unknown

    • Response = unknown

    Parameters

    • numberOfWorkers: number

      Number of workers that this pool should manage.

    • filePath: string

      Path to the worker file.

    • opts: PoolOptions<Worker>

      Options for the pool.

      -

    Returns AbstractPool<Worker, Data, Response>

Properties

Private destroying

destroying: boolean

Whether the pool is destroying or not.

-

Optional emitter

emitter?: EventEmitterAsyncResource

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

Returns AbstractPool<Worker, Data, Response>

Properties

Private destroying

destroying: boolean

Whether the pool is destroying or not.

+

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:

    @@ -118,147 +123,147 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
  • '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).
-

Protected Readonly filePath

filePath: string

Path to the worker file.

-

Protected Optional Readonly max

max?: number

Dynamic pool maximum size property placeholder.

-

Protected Readonly numberOfWorkers

numberOfWorkers: number

Number of workers that this pool should manage.

-

Protected Readonly opts

opts: PoolOptions<Worker>

Options for the pool.

-

Protected promiseResponseMap

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

The task execution response promise map:

+

Protected Readonly filePath

filePath: string

Path to the worker file.

+

Protected Optional Readonly max

max?: number

Dynamic pool maximum size property placeholder.

+

Protected Readonly numberOfWorkers

numberOfWorkers: number

Number of workers that this pool should manage.

+

Protected Readonly opts

opts: PoolOptions<Worker>

Options for the pool.

+

Protected promiseResponseMap

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.

When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

-

Private readyEventEmitted

readyEventEmitted: boolean

Whether the pool ready event has been emitted or not.

-

Private Readonly startTimestamp

startTimestamp: number

The start timestamp of the pool.

-

Private started

started: boolean

Whether the pool is started or not.

-

Private starting

starting: boolean

Whether the pool is starting or not.

-

Private Readonly taskFunctions

taskFunctions: Map<string, TaskFunction<Data, Response>>

The task functions added at runtime map:

+

Private readyEventEmitted

readyEventEmitted: boolean

Whether the pool ready event has been emitted or not.

+

Private Readonly startTimestamp

startTimestamp: number

The start timestamp of the pool.

+

Private started

started: boolean

Whether the pool is started or not.

+

Private starting

starting: boolean

Whether the pool is starting or not.

+

Private Readonly taskFunctions

taskFunctions: Map<string, TaskFunction<Data, Response>>

The task functions added at runtime map:

  • key: The task function name.
  • value: The task function itself.
-

Protected workerChoiceStrategyContext

workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

Worker choice strategy context referencing a worker choice algorithm implementation.

-

Readonly Internal workerNodes

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

Pool worker nodes.

-

Accessors

Protected Abstract busy

Protected workerChoiceStrategyContext

workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

Worker choice strategy context referencing a worker choice algorithm implementation.

+

Readonly Internal workerNodes

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

Pool worker nodes.

+

Accessors

Protected Abstract busy

Protected full

Protected full

info

Protected maxSize

Protected minSize

Private ready

Protected Abstract type

info

Protected maxSize

Protected minSize

Private ready

Protected Abstract type

  • get type(): "fixed" | "dynamic"

  • The pool type.

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

    -

    Returns "fixed" | "dynamic"

Private utilization

Private utilization

Protected Abstract worker

Methods

addTaskFunction

Protected Abstract worker

Methods

addTaskFunction

Private addWorkerNode

Private addWorkerNode

Protected afterTaskExecutionHook

Protected afterTaskExecutionHook

  • Hook executed after the worker task execution. Can be overridden.

    Parameters

    • workerNodeKey: number

      The worker node key.

    • message: MessageValue<Response, unknown>

      The received message.

      -

    Returns void

Protected afterWorkerNodeSetup

  • Method hooked up after a worker node has been newly created. +

Returns void

Protected afterWorkerNodeSetup

  • Method hooked up after a worker node has been newly created. Can be overridden.

    Parameters

    • workerNodeKey: number

      The newly created worker node key.

      -

    Returns void

Protected beforeTaskExecutionHook

  • Hook executed before the worker task execution. +

Returns void

Protected beforeTaskExecutionHook

  • Hook executed before the worker task execution. Can be overridden.

    Parameters

    • workerNodeKey: number

      The worker node key.

    • task: Task<Data>

      The task to execute.

      -

    Returns void

Private buildTasksQueueOptions

Private checkAndEmitDynamicWorkerCreationEvents

Private checkAndEmitTaskExecutionEvents

Private checkAndEmitTaskQueuingEvents

Private checkMessageWorkerId

  • Checks if the worker id sent in the received message from a worker is valid.

    +

Returns void

Private buildTasksQueueOptions

Private checkAndEmitDynamicWorkerCreationEvents

Private checkAndEmitTaskExecutionEvents

Private checkAndEmitTaskQueuingEvents

Private checkMessageWorkerId

Private checkNumberOfWorkers

Private checkPoolOptions

Private checkValidWorkerChoiceStrategyOptions

Private chooseWorkerNode

Private checkNumberOfWorkers

Private checkPoolOptions

Private checkValidWorkerChoiceStrategyOptions

Private chooseWorkerNode

  • Chooses a worker node for the next task.

    The default worker choice strategy uses a round robin algorithm to distribute the tasks.

    Returns number

    The chosen worker node key

    -

Protected createAndSetupDynamicWorkerNode

Protected createAndSetupDynamicWorkerNode

  • Creates a new, completely set up dynamic worker node.

    Returns number

    New, completely set up dynamic worker node key.

    -

Protected createAndSetupWorkerNode

Protected createAndSetupWorkerNode

  • Creates a new, completely set up worker node.

    Returns number

    New, completely set up worker node key.

    -

Protected Abstract createWorker

Protected Abstract createWorker

Private deleteTaskFunctionWorkerUsages

Private dequeueTask

Protected Abstract deregisterWorkerMessageListener

  • Deregisters a listener callback on the worker given its worker node key.

    +

Private deleteTaskFunctionWorkerUsages

Private dequeueTask

Protected Abstract deregisterWorkerMessageListener

  • 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

          Returns void

    Returns void

destroy

Protected Abstract destroyWorkerNode

  • Terminates the worker node given its worker node key.

    +
      • (message): void

      • Parameters

        Returns void

Returns void

destroy

Protected Abstract destroyWorkerNode

  • Terminates the worker node given its worker node key.

    Parameters

    • workerNodeKey: number

      The worker node key.

      -

    Returns Promise<void>

enableTasksQueue

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

    +

Returns Promise<void>

enableTasksQueue

  • 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

Private enqueueTask

execute

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

    +

Returns void

Private enqueueTask

execute

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

    • Optional transferList: TransferListItem[]

      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<Response>

    Promise that will be fulfilled when the task is completed.

    -

Private executeTask

Private executeTask

  • Executes the given task on the worker given its worker node key.

    Parameters

    • workerNodeKey: number

      The worker node key.

    • task: Task<Data>

      The task to execute.

      -

    Returns void

Protected flagWorkerNodeAsNotReady

Protected flushTasksQueue

Private flushTasksQueues

Protected getWorkerInfo

  • Gets the worker information given its worker node key.

    +

Returns void

Protected flagWorkerNodeAsNotReady

Protected flushTasksQueue

Private flushTasksQueues

Protected getWorkerInfo

Private getWorkerNodeKeyByWorker

Private getWorkerNodeKeyByWorker

  • Gets the given worker its worker node key.

    Parameters

    • worker: Worker

      The worker.

    Returns number

    The worker node key if found in the pool worker nodes, -1 otherwise.

    -

Private getWorkerNodeKeyByWorkerId

Private getWorkerNodeKeyByWorkerId

  • Gets the worker node key given its worker id.

    Parameters

    • workerId: undefined | number

      The worker id.

    Returns number

    The worker node key if the worker id is found in the pool worker nodes, -1 otherwise.

    -

Private Readonly handleBackPressureEvent

Private Readonly handleIdleWorkerNodeEvent

Private handleTaskExecutionResponse

Private handleWorkerReadyResponse

Private hasBackPressure

hasTaskFunction

Private Readonly handleBackPressureEvent

Private Readonly handleIdleWorkerNodeEvent

Private handleTaskExecutionResponse

Private handleWorkerReadyResponse

Private hasBackPressure

hasTaskFunction

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

    -

hasWorkerNodeBackPressure

hasWorkerNodeBackPressure

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

    -

Private initializeEventEmitter

Protected internalBusy

Private initializeEventEmitter

Protected internalBusy

  • Whether worker nodes are executing concurrently their tasks quota or not.

    Returns boolean

    Worker nodes busyness boolean status.

    -

Protected Abstract isMain

listTaskFunctionNames

Protected Abstract isMain

listTaskFunctionNames

Private redistributeQueuedTasks

Protected Abstract registerOnceWorkerMessageListener

Private redistributeQueuedTasks

Protected Abstract registerOnceWorkerMessageListener

  • 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

          Returns void

    Returns void

Protected Abstract registerWorkerMessageListener

  • Registers a listener callback on the worker given its worker node key.

    +
      • (message): void

      • Parameters

        Returns void

Returns void

Protected Abstract registerWorkerMessageListener

  • 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

          Returns void

    Returns void

removeTaskFunction

  • Removes a task function from this pool.

    +
      • (message): void

      • Parameters

        Returns void

Returns void

removeTaskFunction

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

    -

Private removeWorkerNode

Private removeWorkerNode

  • Removes the given worker from the pool worker nodes.

    Parameters

    • worker: Worker

      The worker.

      -

    Returns void

Protected sendKillMessageToWorker

Protected Abstract sendStartupMessageToWorker

  • Sends the startup message to worker given its worker node key.

    +

Returns void

Private resetTaskSequentiallyStolenStatisticsTaskFunctionWorkerUsage

  • Parameters

    • workerNodeKey: number
    • taskName: string

    Returns void

Private resetTaskSequentiallyStolenStatisticsWorkerUsage

Protected sendKillMessageToWorker

Protected Abstract sendStartupMessageToWorker

  • Sends the startup message to worker given its worker node key.

    Parameters

    • workerNodeKey: number

      The worker node key.

      -

    Returns void

Private sendStatisticsMessageToWorker

  • Sends the statistics message to worker given its worker node key.

    +

Returns void

Private sendStatisticsMessageToWorker

  • Sends the statistics message to worker given its worker node key.

    Parameters

    • workerNodeKey: number

      The worker node key.

      -

    Returns void

Private sendTaskFunctionOperationToWorker

Private sendTaskFunctionOperationToWorkers

Protected Abstract sendToWorker

  • Sends a message to worker given its worker node key.

    +

Returns void

Private sendTaskFunctionOperationToWorker

Private sendTaskFunctionOperationToWorkers

Protected Abstract sendToWorker

  • Sends a message to worker given its worker node key.

    Parameters

    • workerNodeKey: number

      The worker node key.

    • message: MessageValue<Data, unknown>

      The message.

    • Optional transferList: TransferListItem[]

      The optional array of transferable objects.

      -

    Returns void

setDefaultTaskFunction

  • Sets the default task function in this pool.

    +

Returns void

setDefaultTaskFunction

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

    -

Private setTaskStealing

setTasksQueueOptions

Private setTaskStealing

setTasksQueueOptions

Private setTasksQueueSize

Private setTasksStealingOnBackPressure

setWorkerChoiceStrategy

  • Sets the worker choice strategy in this pool.

    +

Returns void

Private setTasksQueueSize

Private setTasksStealingOnBackPressure

setWorkerChoiceStrategy

  • 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

setWorkerChoiceStrategyOptions

  • Sets the worker choice strategy options in this pool.

    +

Returns void

setWorkerChoiceStrategyOptions

Protected setupHook

  • Setup hook to execute code before worker nodes are created in the abstract constructor. +

Returns void

Protected setupHook

  • Setup hook to execute code before worker nodes are created in the abstract constructor. Can be overridden.

    -

    Returns void

Private shallCreateDynamicWorker

Private shallCreateDynamicWorker

  • Conditions for dynamic worker creation.

    Returns boolean

    Whether to create a dynamic worker or not.

    -

Private shallExecuteTask

Private shallUpdateTaskFunctionWorkerUsage

  • Whether the worker node shall update its task function worker usage or not.

    +

Private shallExecuteTask

Private shallUpdateTaskFunctionWorkerUsage

  • Whether the worker node shall update its task function worker usage or not.

    Parameters

    • workerNodeKey: number

      The worker node key.

    Returns boolean

    true if the worker node shall update its task function worker usage, false otherwise.

    -

start

Private tasksQueueSize

Private unsetTaskStealing

Private unsetTasksStealingOnBackPressure

Private updateEluWorkerUsage

Private updateRunTimeWorkerUsage

Private updateTaskStatisticsWorkerUsage

Private updateTaskStolenStatisticsWorkerUsage

  • Parameters

    • workerNodeKey: number
    • taskName: string

    Returns void

Private updateWaitTimeWorkerUsage

Protected workerMessageListener

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc

\ No newline at end of file +

start

Private tasksQueueSize

Private unsetTaskStealing

Private unsetTasksStealingOnBackPressure

Private updateEluWorkerUsage

Private updateRunTimeWorkerUsage

Private updateTaskSequentiallyStolenStatisticsTaskFunctionWorkerUsage

  • Parameters

    • workerNodeKey: number
    • taskName: string

    Returns void

Private updateTaskSequentiallyStolenStatisticsWorkerUsage

  • Parameters

    • workerNodeKey: number

    Returns void

Private updateTaskStatisticsWorkerUsage

Private updateTaskStolenStatisticsWorkerUsage

  • Parameters

    • workerNodeKey: number
    • taskName: string

    Returns void

Private updateWaitTimeWorkerUsage

Protected workerMessageListener

Private Readonly workerNodeStealTask

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc

\ No newline at end of file diff --git a/docs/classes/AbstractWorker.html b/docs/classes/AbstractWorker.html index c4e0f319..6f9065e4 100644 --- a/docs/classes/AbstractWorker.html +++ b/docs/classes/AbstractWorker.html @@ -1,8 +1,8 @@ -AbstractWorker | poolifier - v3.0.7

Class AbstractWorker<MainWorker, Data, Response>Abstract

Base class that implements some shared logic for all poolifier workers.

+AbstractWorker | poolifier - v3.0.8

Class AbstractWorker<MainWorker, Data, Response>Abstract

Base class that implements some shared logic for all poolifier workers.

Type Parameters

  • MainWorker extends Worker | MessagePort

    Type of main worker.

  • Data = unknown

    Type of data this worker receives from pool's execution. This can only be structured-cloneable data.

  • Response = unknown

    Type of response the worker sends back to the main worker. This can only be structured-cloneable data.

    -

Hierarchy

Constructors

constructor +

Hierarchy

Constructors

constructor

Properties

activeInterval? id isMain @@ -49,59 +49,59 @@
  • mainWorker: MainWorker

    Reference to main worker.

  • taskFunctions: TaskFunction<Data, Response> | TaskFunctions<Data, Response>

    Task function(s) processed by the worker when the pool's execution function is invoked. The first function is the default function.

  • opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -

    • Returns AbstractWorker<MainWorker, Data, Response>

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    -

    Protected Abstract id

    id: number

    Worker id.

    -

    Protected Readonly isMain

    isMain: boolean

    Whether this is the main worker or not.

    -

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    -

    Private Readonly mainWorker

    mainWorker: MainWorker

    Reference to main worker.

    -

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -

    Protected statistics

    statistics: WorkerStatistics

    Performance statistics computation requirements.

    -

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunction<Data, Response>>

    Task function(s) processed by the worker when the pool's execution function is invoked.

    -

    Methods

    addTaskFunction

    Returns AbstractWorker<MainWorker, Data, Response>

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    +

    Protected Abstract id

    id: number

    Worker id.

    +

    Protected Readonly isMain

    isMain: boolean

    Whether this is the main worker or not.

    +

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    +

    Private Readonly mainWorker

    mainWorker: MainWorker

    Reference to main worker.

    +

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    +

    Protected statistics

    statistics: WorkerStatistics

    Performance statistics computation requirements.

    +

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunction<Data, Response>>

    Task function(s) processed by the worker when the pool's execution function is invoked.

    +

    Methods

    addTaskFunction

    asyncId

    • Returns number

      The unique asyncId assigned to the resource.

      -

    Private beginTaskPerformance

    bind

    asyncId

    • Returns number

      The unique asyncId assigned to the resource.

      +

    Private beginTaskPerformance

    bind

    • Binds the given function to execute to this AsyncResource's scope.

      Type Parameters

      • Func extends ((...args) => any)

      Parameters

      • fn: Func

        The function to bind to the current AsyncResource.

      Returns Func

      Since

      v14.8.0, v12.19.0

    Private checkActive

    Private checkMessageWorkerId

    Private checkMessageWorkerId

    Private checkStatistics

    Private checkTaskFunctions

    Private checkStatistics

    Private checkTaskFunctions

    • Checks if the taskFunctions parameter is passed to the constructor and valid.

      Parameters

      • taskFunctions: TaskFunction<Data, Response> | TaskFunctions<Data, Response>

        The task function(s) parameter that should be checked.

        -

      Returns void

    Private checkWorkerOptions

    emitDestroy

    • Call all destroy hooks. This should only ever be called once. An error will +

    Returns void

    Private checkWorkerOptions

    emitDestroy

    • Call all destroy hooks. This should only ever be called once. An error will be thrown if it is called more than once. This must be manually called. If the resource is left to be collected by the GC then the destroy hooks will never be called.

      Returns AbstractWorker<MainWorker, Data, Response>

      A reference to asyncResource.

      -

    Private endTaskPerformance

    Protected getMainWorker

    • Returns the main worker.

      +

    Private endTaskPerformance

    Protected getMainWorker

    Protected handleError

    Protected handleError

    • Handles an error and convert it to a string so it can be sent back to the main worker.

      Parameters

      • error: string | Error

        The error raised by the worker.

      Returns string

      The error message.

      -

    Protected handleKillMessage

    Protected Abstract handleReadyMessage

    Protected handleKillMessage

    Protected Abstract handleReadyMessage

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    Returns void

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    listTaskFunctionNames

    listTaskFunctionNames

    • Lists the names of the worker's task functions.

      Returns string[]

      The names of the worker's task functions.

      -

    Protected messageListener

    Protected messageListener

    removeTaskFunction

    Returns void

    removeTaskFunction

    Protected run

    Protected run

    Protected runAsync

    • Runs the given task function asynchronously.

      +

    Returns void

    Protected runAsync

    runInAsyncScope

    • Call the provided function with the provided arguments in the execution context +

    Returns void

    runInAsyncScope

    • Call the provided function with the provided arguments in the execution context of the async resource. This will establish the context, trigger the AsyncHooks before callbacks, call the function, trigger the AsyncHooks after callbacks, and then restore the original execution context.

      @@ -112,17 +112,17 @@ then restore the original execution context.

    Protected runSync

    Protected sendTaskFunctionNamesToMainWorker

    Protected Abstract sendToMainWorker

    • Sends a message to main worker.

      +

    Returns void

    Protected sendTaskFunctionNamesToMainWorker

    Protected Abstract sendToMainWorker

    setDefaultTaskFunction

    Returns void

    setDefaultTaskFunction

    Private startCheckActive

    Private stopCheckActive

    triggerAsyncId

    • Returns number

      The same triggerAsyncId that is passed to the AsyncResource constructor.

      -

    Private updateLastTaskTimestamp

    Static bind

    Private startCheckActive

    Private stopCheckActive

    triggerAsyncId

    • Returns number

      The same triggerAsyncId that is passed to the AsyncResource constructor.

      +

    Private updateLastTaskTimestamp

    Static bind

    • Binds the given function to the current execution context.

      Type Parameters

      • Func extends ((this, ...args) => any)

      • ThisArg

      Parameters

      • fn: Func

        The function to bind to the current execution context.

      • Optional type: string

        An optional name to associate with the underlying AsyncResource.

      • Optional thisArg: ThisArg

      Returns Func

      Since

      v14.8.0, v12.19.0

      -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/classes/CircularArray.html b/docs/classes/CircularArray.html index 9d6799cb..7e838406 100644 --- a/docs/classes/CircularArray.html +++ b/docs/classes/CircularArray.html @@ -1,5 +1,5 @@ -CircularArray | poolifier - v3.0.7

    Class CircularArray<T>Internal

    Array with a maximum length and shifting items when full.

    -

    Type Parameters

    • T

    Hierarchy

    • Array<T>
      • CircularArray

    Constructors

    constructor +CircularArray | poolifier - v3.0.8

    Class CircularArray<T>Internal

    Array with a maximum length and shifting items when full.

    +

    Type Parameters

    • T

    Hierarchy

    • Array<T>
      • CircularArray

    Constructors

    constructor

    Properties

    [unscopables] length size @@ -44,23 +44,23 @@ from isArray of -

    Constructors

    constructor

    Properties

    Readonly [unscopables]

    [unscopables]: {
        [unscopables]?: boolean;
        length?: boolean;
        [iterator]?: any;
        at?: any;
        concat?: any;
        copyWithin?: any;
        entries?: any;
        every?: any;
        fill?: any;
        filter?: any;
        find?: any;
        findIndex?: any;
        flat?: any;
        flatMap?: any;
        forEach?: any;
        includes?: any;
        indexOf?: any;
        join?: any;
        keys?: any;
        lastIndexOf?: any;
        map?: any;
        pop?: any;
        push?: any;
        reduce?: any;
        reduceRight?: any;
        reverse?: any;
        shift?: any;
        slice?: any;
        some?: any;
        sort?: any;
        splice?: any;
        toLocaleString?: any;
        toString?: any;
        unshift?: any;
        values?: any;
    }

    Is an object whose properties have the value 'true' +

    Constructors

    constructor

    Properties

    Readonly [unscopables]

    [unscopables]: {
        [unscopables]?: boolean;
        length?: boolean;
        [iterator]?: any;
        at?: any;
        concat?: any;
        copyWithin?: any;
        entries?: any;
        every?: any;
        fill?: any;
        filter?: any;
        find?: any;
        findIndex?: any;
        flat?: any;
        flatMap?: any;
        forEach?: any;
        includes?: any;
        indexOf?: any;
        join?: any;
        keys?: any;
        lastIndexOf?: any;
        map?: any;
        pop?: any;
        push?: any;
        reduce?: any;
        reduceRight?: any;
        reverse?: any;
        shift?: any;
        slice?: any;
        some?: any;
        sort?: any;
        splice?: any;
        toLocaleString?: any;
        toString?: any;
        unshift?: any;
        values?: any;
    }

    Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement.

    Type declaration

    • Optional Readonly [unscopables]?: boolean

      Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement.

    • Optional length?: boolean

      Gets or sets the length of the array. This is a number one higher than the highest index in the array.

    length

    length: number

    Gets or sets the length of the array. This is a number one higher than the highest index in the array.

    -

    size

    size: number

    Static Readonly [species]

    [species]: ArrayConstructor

    Methods

    [iterator]

    • [iterator](): IterableIterator<T>

    • Iterator

      +

    size

    size: number

    Static Readonly [species]

    [species]: ArrayConstructor

    Methods

    [iterator]

    • [iterator](): IterableIterator<T>

    • Iterator

      Returns IterableIterator<T>

    at

    • Returns the item located at the specified index.

      Parameters

      • index: number

        The zero-based index of the desired code unit. A negative index will count back from the last item.

        -

      Returns undefined | T

    Private checkSize

    concat

    copyWithin

    • Returns the this object after copying a section of the array identified by start and end +

    Returns undefined | T

    Private checkSize

    concat

    copyWithin

    • Returns the this object after copying a section of the array identified by start and end to the same array starting at position target

      Parameters

      • target: number

        If target is negative, it is treated as length+target where length is the length of the array.

      • start: number

        If start is negative, it is treated as length+start. If end is negative, it is treated as length+end.

      • Optional end: number

        If not specified, length of the this object is used as its default value.

        -

      Returns CircularArray<T>

    empty

    entries

    • Returns an iterable of key, value pairs for every entry in the array

      +

    Returns CircularArray<T>

    empty

    entries

    • Returns an iterable of key, value pairs for every entry in the array

      Returns IterableIterator<[number, T]>

    every

    • Determines whether all the members of an array satisfy the specified test.

      Type Parameters

      • S

      Parameters

      • predicate: ((value, index, array) => value is S)

        A function that accepts up to three arguments. The every method calls the predicate function for each element in the array until the predicate returns a value @@ -112,7 +112,7 @@ thisArg is omitted, undefined is used as the this value.

      Returns U[]

    forEach

    • Performs the specified action for each element in an array.

      Parameters

      • callbackfn: ((value, index, array) => void)

        A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the array.

          • (value, index, array): void

          • Parameters

            • value: T
            • index: number
            • array: T[]

            Returns void

      • Optional thisArg: any

        An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.

        -

      Returns void

    full

    includes

    • Determines whether an array includes a certain element, returning true or false as appropriate.

      +

    Returns void

    full

    includes

    • Determines whether an array includes a certain element, returning true or false as appropriate.

      Parameters

      • searchElement: T

        The element to search for.

      • Optional fromIndex: number

        The position in this array at which to begin searching for searchElement.

      Returns boolean

    indexOf

    • Returns the index of the first occurrence of a value in an array, or -1 if it is not present.

      @@ -129,7 +129,7 @@ thisArg is omitted, undefined is used as the this value.

        • (value, index, array): U

        • Parameters

          • value: T
          • index: number
          • array: T[]

          Returns U

    • Optional thisArg: any

      An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.

    Returns U[]

    pop

    • Removes the last element from an array and returns it. If the array is empty, undefined is returned and the array is not modified.

      -

      Returns undefined | T

    push

    • Parameters

      • Rest ...items: T[]

      Returns number

      Inherit Doc

    reduce

    • Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.

      +

      Returns undefined | T

    push

    • Parameters

      • Rest ...items: T[]

      Returns number

      Inherit Doc

    reduce

    • Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.

      Parameters

      • callbackfn: ((previousValue, currentValue, currentIndex, array) => T)

        A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the array.

          • (previousValue, currentValue, currentIndex, array): T

          • Parameters

            • previousValue: T
            • currentValue: T
            • currentIndex: number
            • array: T[]

            Returns T

      Returns T

    • Parameters

      • callbackfn: ((previousValue, currentValue, currentIndex, array) => T)
          • (previousValue, currentValue, currentIndex, array): T

          • Parameters

            • previousValue: T
            • currentValue: T
            • currentIndex: number
            • array: T[]

            Returns T

      • initialValue: T

      Returns T

    • Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.

      Type Parameters

      • U

      Parameters

      • callbackfn: ((previousValue, currentValue, currentIndex, array) => U)

        A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the array.

        @@ -139,7 +139,7 @@ If the array is empty, undefined is returned and the array is not modified.

          • (previousValue, currentValue, currentIndex, array): T

          • Parameters

            • previousValue: T
            • currentValue: T
            • currentIndex: number
            • array: T[]

            Returns T

      Returns T

    • Parameters

      • callbackfn: ((previousValue, currentValue, currentIndex, array) => T)
          • (previousValue, currentValue, currentIndex, array): T

          • Parameters

            • previousValue: T
            • currentValue: T
            • currentIndex: number
            • array: T[]

            Returns T

      • initialValue: T

      Returns T

    • Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.

      Type Parameters

      • U

      Parameters

      • callbackfn: ((previousValue, currentValue, currentIndex, array) => U)

        A function that accepts up to four arguments. The reduceRight method calls the callbackfn function one time for each element in the array.

          • (previousValue, currentValue, currentIndex, array): U

          • Parameters

            • previousValue: U
            • currentValue: T
            • currentIndex: number
            • array: T[]

            Returns U

      • initialValue: U

        If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an array value.

        -

      Returns U

    resize

    reverse

    • Reverses the elements in an array in place. +

    Returns U

    resize

    reverse

    • Reverses the elements in an array in place. This method mutates the array and returns a reference to the same array.

      Returns T[]

    shift

    • Removes the first element from an array and returns it. If the array is empty, undefined is returned and the array is not modified.

      @@ -163,9 +163,9 @@ a negative value if the first argument is less than the second argument, zero if value otherwise. If omitted, the elements are sorted in ascending, ASCII character order.

      [11,2,22,1].sort((a, b) => a - b)
      -
        • (a, b): number

        • Parameters

          • a: T
          • b: T

          Returns number

    Returns CircularArray<T>

    splice

    toLocaleString

    • Returns a string representation of an array. The elements are converted to string using their toLocaleString methods.

      +
        • (a, b): number

        • Parameters

          • a: T
          • b: T

          Returns number

    Returns CircularArray<T>

    splice

    toLocaleString

    • Returns a string representation of an array. The elements are converted to string using their toLocaleString methods.

      Returns string

    toString

    • Returns a string representation of an array.

      -

      Returns string

    unshift

    • Parameters

      • Rest ...items: T[]

      Returns number

      Inherit Doc

    values

    • Returns an iterable of values in the array

      +

      Returns string

    unshift

    • Parameters

      • Rest ...items: T[]

      Returns number

      Inherit Doc

    values

    • Returns an iterable of values in the array

      Returns IterableIterator<T>

    Static from

    • Creates an array from an array-like object.

      Type Parameters

      • T

      Parameters

      • arrayLike: ArrayLike<T>

        An array-like object to convert to an array.

      Returns T[]

    • Creates an array from an iterable object.

      @@ -180,4 +180,4 @@ value otherwise. If omitted, the elements are sorted in ascending, ASCII charact
        • (v, k): U

        • Parameters

          • v: T
          • k: number

          Returns U

    • Optional thisArg: any

      Value of 'this' used to invoke the mapfn.

    Returns U[]

    Static isArray

    • Parameters

      • arg: any

      Returns arg is any[]

    Static of

    • Returns a new array from a set of elements.

      Type Parameters

      • T

      Parameters

      • Rest ...items: T[]

        A set of elements to include in the new array object.

        -

      Returns T[]

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Returns T[]

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/classes/ClusterWorker.html b/docs/classes/ClusterWorker.html index 8a320ac1..eeee03aa 100644 --- a/docs/classes/ClusterWorker.html +++ b/docs/classes/ClusterWorker.html @@ -1,4 +1,4 @@ -ClusterWorker | poolifier - v3.0.7

    Class ClusterWorker<Data, Response>

    A cluster worker used by a poolifier ClusterPool.

    +ClusterWorker | poolifier - v3.0.8

    Class ClusterWorker<Data, Response>

    A cluster worker used by a poolifier ClusterPool.

    When this worker is inactive for more than the given maxInactiveTime, it will send a termination request to its main worker.

    If you use a DynamicClusterPool the extra workers that were created will be terminated, @@ -7,7 +7,7 @@ but the minimum number of workers will be guaranteed.

    Since

    2.0.0

    Type Parameters

    • Data = unknown

      Type of data this worker receives from pool's execution. This can only be structured-cloneable data.

    • Response = unknown

      Type of response the worker sends back to the main worker. This can only be structured-cloneable data.

      -

    Hierarchy

    Constructors

    constructor +

    Hierarchy

    Constructors

    constructor

    Properties

    activeInterval? isMain lastTaskTimestamp @@ -40,19 +40,19 @@ but the minimum number of workers will be guaranteed.

    Constructors

    constructor

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    -

    Protected Readonly isMain

    isMain: boolean

    Whether this is the main worker or not.

    -

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    -

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -

    Protected statistics

    statistics: WorkerStatistics

    Performance statistics computation requirements.

    -

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunction<Data, Response>>

    Task function(s) processed by the worker when the pool's execution function is invoked.

    -

    Accessors

    Protected id

    Methods

    addTaskFunction

    Returns ClusterWorker<Data, Response>

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    +

    Protected Readonly isMain

    isMain: boolean

    Whether this is the main worker or not.

    +

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    +

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    +

    Protected statistics

    statistics: WorkerStatistics

    Performance statistics computation requirements.

    +

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunction<Data, Response>>

    Task function(s) processed by the worker when the pool's execution function is invoked.

    +

    Accessors

    Protected id

    Methods

    addTaskFunction

    asyncId

    asyncId

    • Returns number

      The unique asyncId assigned to the resource.

    bind

    • Binds the given function to execute to this AsyncResource's scope.

      Type Parameters

      • Func extends ((...args) => any)

      Parameters

      • fn: Func

        The function to bind to the current AsyncResource.

      Returns Func

      Since

      v14.8.0, v12.19.0

      @@ -64,28 +64,28 @@ never be called.

    Protected getMainWorker

    Protected handleError

    Protected handleError

    • Handles an error and convert it to a string so it can be sent back to the main worker.

      Parameters

      • error: string | Error

        The error raised by the worker.

      Returns string

      The error message.

      -

    Protected handleKillMessage

    Protected handleReadyMessage

    Protected handleKillMessage

    Protected handleReadyMessage

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    Returns void

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    listTaskFunctionNames

    listTaskFunctionNames

    Protected messageListener

    Protected messageListener

    removeTaskFunction

    Returns void

    removeTaskFunction

    Protected run

    Protected run

    Protected runAsync

    • Runs the given task function asynchronously.

      +

    Returns void

    Protected runAsync

    runInAsyncScope

    • Call the provided function with the provided arguments in the execution context +

    Returns void

    runInAsyncScope

    • Call the provided function with the provided arguments in the execution context of the async resource. This will establish the context, trigger the AsyncHooks before callbacks, call the function, trigger the AsyncHooks after callbacks, and then restore the original execution context.

      @@ -96,15 +96,15 @@ then restore the original execution context.

    Protected runSync

    Protected sendTaskFunctionNamesToMainWorker

    Protected sendToMainWorker

    • Sends a message to main worker.

      +

    Returns void

    Protected sendTaskFunctionNamesToMainWorker

    Protected sendToMainWorker

    setDefaultTaskFunction

    Returns void

    setDefaultTaskFunction

    triggerAsyncId

    triggerAsyncId

    • Returns number

      The same triggerAsyncId that is passed to the AsyncResource constructor.

    Static bind

    • Binds the given function to the current execution context.

      Type Parameters

      • Func extends ((this, ...args) => any)

      • ThisArg

      Parameters

      • fn: Func

        The function to bind to the current execution context.

      • Optional type: string

        An optional name to associate with the underlying AsyncResource.

      • Optional thisArg: ThisArg

      Returns Func

      Since

      v14.8.0, v12.19.0

      -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/classes/Deque.html b/docs/classes/Deque.html index 4486260a..db76e9e1 100644 --- a/docs/classes/Deque.html +++ b/docs/classes/Deque.html @@ -1,7 +1,7 @@ -Deque | poolifier - v3.0.7

    Class Deque<T>Internal

    Deque. +Deque | poolifier - v3.0.8

    Class Deque<T>Internal

    Deque. Implemented with a doubly linked list.

    Type Parameters

    • T

      Type of deque data.

      -

    Hierarchy

    • Deque

    Constructors

    constructor +

    Hierarchy

    • Deque

    Constructors

    constructor

    Properties

    head? maxSize size @@ -16,27 +16,27 @@ Implemented with a doubly linked list.

    push shift unshift -

    Constructors

    constructor

    Properties

    Private Optional head

    head?: Node<T>

    maxSize

    maxSize: number

    The maximum size of the deque.

    -

    size

    size: number

    The size of the deque.

    -

    Private Optional tail

    tail?: Node<T>

    Methods

    [iterator]

    • [iterator](): Iterator<T, any, undefined>

    • Returns an iterator for the deque.

      +

    Constructors

    constructor

    Properties

    Private Optional head

    head?: Node<T>

    maxSize

    maxSize: number

    The maximum size of the deque.

    +

    size

    size: number

    The size of the deque.

    +

    Private Optional tail

    tail?: Node<T>

    Methods

    [iterator]

    backward

    • Returns an backward iterator for the deque.

      +

    backward

    clear

    Private incrementSize

    peekFirst

    clear

    Private incrementSize

    peekFirst

    • Peeks at the first data.

      Returns undefined | T

      The first data or undefined if the deque is empty.

      -

    peekLast

    peekLast

    • Peeks at the last data.

      Returns undefined | T

      The last data or undefined if the deque is empty.

      -

    pop

    pop

    • Pops data from the deque.

      Returns undefined | T

      The popped data or undefined if the deque is empty.

      -

    push

    push

    • Appends data to the deque.

      Parameters

      • data: T

        Data to append.

      Returns number

      The new size of the queue.

      -

    shift

    • Shifts data from the deque.

      +

    shift

    • Shifts data from the deque.

      Returns undefined | T

      The shifted data or undefined if the deque is empty.

      -

    unshift

    • Prepends data to the deque.

      +

    unshift

    • Prepends data to the deque.

      Parameters

      • data: T

        Data to prepend.

      Returns number

      The new size of the queue.

      -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/classes/DynamicClusterPool.html b/docs/classes/DynamicClusterPool.html index 69d0190f..e60f835d 100644 --- a/docs/classes/DynamicClusterPool.html +++ b/docs/classes/DynamicClusterPool.html @@ -1,11 +1,11 @@ -DynamicClusterPool | poolifier - v3.0.7

    Class DynamicClusterPool<Data, Response>

    A cluster pool with a dynamic number of workers, but a guaranteed minimum number of workers.

    +DynamicClusterPool | poolifier - v3.0.8

    Class DynamicClusterPool<Data, Response>

    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 and workers are busy, an event is emitted. If you want to listen to this event, use the pool's emitter.

    Author

    Christopher Quadflieg

    Since

    2.0.0

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy

    Constructors

    constructor +

    Hierarchy

    Constructors

    constructor

    Properties

    emitter? filePath max @@ -61,7 +61,7 @@ When the maximum number of workers is reached and workers are busy, an event is
  • max: number

    Maximum number of workers that can be created by this pool.

  • filePath: string

    Path to an implementation of a ClusterWorker file, which can be relative or absolute.

  • opts: ClusterPoolOptions = {}

    Options for this dynamic cluster pool.

    -

    • Returns DynamicClusterPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

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

    Returns DynamicClusterPool<Data, Response>

    Properties

    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:

      @@ -73,109 +73,109 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • '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).
    -

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    -

    Protected Readonly max

    max: number

    Maximum number of workers that can be created by this pool.

    -

    Protected Readonly numberOfWorkers

    numberOfWorkers: number

    Number of workers that this pool should manage.

    -

    Protected Readonly opts

    opts: ClusterPoolOptions = {}

    Options for this fixed cluster pool.

    -

    Protected promiseResponseMap

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

    The task execution response promise map:

    +

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    +

    Protected Readonly max

    max: number

    Maximum number of workers that can be created by this pool.

    +

    Protected Readonly numberOfWorkers

    numberOfWorkers: number

    Number of workers that this pool should manage.

    +

    Protected Readonly opts

    opts: ClusterPoolOptions = {}

    Options for this fixed cluster pool.

    +

    Protected promiseResponseMap

    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.

    When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

    -

    Protected workerChoiceStrategyContext

    workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

    Worker choice strategy context referencing a worker choice algorithm implementation.

    -

    Readonly Internal workerNodes

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

    Pool worker nodes.

    -

    Accessors

    Protected busy

    Protected workerChoiceStrategyContext

    workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

    Worker choice strategy context referencing a worker choice algorithm implementation.

    +

    Readonly Internal workerNodes

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

    Pool worker nodes.

    +

    Accessors

    Protected busy

    • get busy(): boolean

    • Whether the pool is busy or not.

      The pool busyness boolean status.

      -

      Returns boolean

    Protected full

    Protected full

    • get full(): boolean

    • Whether the pool is full or not.

      The pool filling boolean status.

      -

      Returns boolean

    info

    Protected maxSize

    Protected minSize

    Private ready

    Protected type

    info

    Protected maxSize

    Protected minSize

    Private ready

    Protected type

    • get type(): "fixed" | "dynamic"

    • The pool type.

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

      -

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      +

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      Returns number

      The pool utilization.

      -

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      -

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    • Adds a task function to this pool. +

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      +

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    Protected afterTaskExecutionHook

    Protected afterWorkerNodeSetup

    • Method hooked up after a worker node has been newly created. +

    Returns void

    Protected afterWorkerNodeSetup

    Protected beforeTaskExecutionHook

    • Hook executed before the worker task execution. +

    Returns void

    Protected beforeTaskExecutionHook

    Protected createAndSetupDynamicWorkerNode

    • Creates a new, completely set up dynamic worker node.

      +

    Returns void

    Protected createAndSetupDynamicWorkerNode

    Protected createAndSetupWorkerNode

    Protected createAndSetupWorkerNode

    Protected createWorker

    Protected createWorker

    Protected deregisterWorkerMessageListener

    Protected deregisterWorkerMessageListener

    • 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

            Returns void

      Returns void

    destroy

    Protected destroyWorkerNode

    • Terminates the worker node given its worker node key.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    destroy

    Protected destroyWorkerNode

    enableTasksQueue

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

      +

    Returns Promise<void>

    enableTasksQueue

    execute

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

      +

    Returns void

    execute

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

      • Optional transferList: TransferListItem[]

        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<Response>

      Promise that will be fulfilled when the task is completed.

      -

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    hasTaskFunction

    hasTaskFunction

    hasWorkerNodeBackPressure

    hasWorkerNodeBackPressure

    Protected internalBusy

    Protected internalBusy

    Protected isMain

    listTaskFunctionNames

    Protected isMain

    listTaskFunctionNames

    Protected registerOnceWorkerMessageListener

    Protected registerOnceWorkerMessageListener

    • 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

            Returns void

      Returns void

    Protected registerWorkerMessageListener

    • Registers a listener callback on the worker given its worker node key.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    Protected registerWorkerMessageListener

    • 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

            Returns void

      Returns void

    removeTaskFunction

    • Removes a task function from this pool.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    removeTaskFunction

    Protected sendKillMessageToWorker

    Protected sendStartupMessageToWorker

    Protected sendKillMessageToWorker

    Protected sendStartupMessageToWorker

    Protected sendToWorker

    • Sends a message to worker given its worker node key.

      +

    Returns void

    Protected sendToWorker

    setDefaultTaskFunction

    • Sets the default task function in this pool.

      +

    Returns void

    setDefaultTaskFunction

    setTasksQueueOptions

    setTasksQueueOptions

    setWorkerChoiceStrategy

    • Sets the worker choice strategy in this pool.

      +

    Returns void

    setWorkerChoiceStrategy

    • 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

    setWorkerChoiceStrategyOptions

    • Sets the worker choice strategy options in this pool.

      +

    Returns void

    setWorkerChoiceStrategyOptions

    Protected setupHook

    • Setup hook to execute code before worker nodes are created in the abstract constructor. +

    Returns void

    Protected setupHook

    start

    Protected workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Returns void

    start

    Protected workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/classes/DynamicThreadPool.html b/docs/classes/DynamicThreadPool.html index 0f323be7..d74e58f3 100644 --- a/docs/classes/DynamicThreadPool.html +++ b/docs/classes/DynamicThreadPool.html @@ -1,11 +1,11 @@ -DynamicThreadPool | poolifier - v3.0.7

    Class DynamicThreadPool<Data, Response>

    A thread pool with a dynamic number of threads, but a guaranteed minimum number of threads.

    +DynamicThreadPool | poolifier - v3.0.8

    Class DynamicThreadPool<Data, Response>

    A thread pool with a dynamic number of threads, but a guaranteed minimum number of threads.

    This thread pool creates new threads when the others are busy, up to the maximum number of threads. When the maximum number of threads is reached and workers are busy, an event is emitted. If you want to listen to this event, use the pool's emitter.

    Author

    Alessandro Pio Ardizio

    Since

    0.0.1

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy

    Constructors

    constructor +

    Hierarchy

    Constructors

    constructor

    Properties

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

    Maximum number of threads that can be created by this pool.

  • filePath: string

    Path to an implementation of a ThreadWorker file, which can be relative or absolute.

  • opts: ThreadPoolOptions = {}

    Options for this dynamic thread pool.

    -

    • Returns DynamicThreadPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

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

    Returns DynamicThreadPool<Data, Response>

    Properties

    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:

      @@ -73,110 +73,110 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • '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).
    -

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    -

    Protected Readonly max

    max: number

    Maximum number of threads that can be created by this pool.

    -

    Protected Readonly numberOfWorkers

    numberOfWorkers: number

    Number of workers that this pool should manage.

    -

    Protected Readonly opts

    opts: ThreadPoolOptions = {}

    Options for this fixed thread pool.

    -

    Protected promiseResponseMap

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

    The task execution response promise map:

    +

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    +

    Protected Readonly max

    max: number

    Maximum number of threads that can be created by this pool.

    +

    Protected Readonly numberOfWorkers

    numberOfWorkers: number

    Number of workers that this pool should manage.

    +

    Protected Readonly opts

    opts: ThreadPoolOptions = {}

    Options for this fixed thread pool.

    +

    Protected promiseResponseMap

    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.

    When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

    -

    Protected workerChoiceStrategyContext

    workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

    Worker choice strategy context referencing a worker choice algorithm implementation.

    -

    Readonly Internal workerNodes

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

    Pool worker nodes.

    -

    Accessors

    Protected busy

    Protected workerChoiceStrategyContext

    workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

    Worker choice strategy context referencing a worker choice algorithm implementation.

    +

    Readonly Internal workerNodes

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

    Pool worker nodes.

    +

    Accessors

    Protected busy

    • get busy(): boolean

    • Whether the pool is busy or not.

      The pool busyness boolean status.

      -

      Returns boolean

    Protected full

    Protected full

    • get full(): boolean

    • Whether the pool is full or not.

      The pool filling boolean status.

      -

      Returns boolean

    info

    Protected maxSize

    Protected minSize

    Private ready

    Protected type

    info

    Protected maxSize

    Protected minSize

    Private ready

    Protected type

    • get type(): "fixed" | "dynamic"

    • The pool type.

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

      -

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      +

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      Returns number

      The pool utilization.

      -

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      -

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    • Adds a task function to this pool. +

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      +

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    Protected afterTaskExecutionHook

    Protected afterWorkerNodeSetup

    • Method hooked up after a worker node has been newly created. +

    Returns void

    Protected afterWorkerNodeSetup

    Protected beforeTaskExecutionHook

    • Hook executed before the worker task execution. +

    Returns void

    Protected beforeTaskExecutionHook

    Protected createAndSetupDynamicWorkerNode

    • Creates a new, completely set up dynamic worker node.

      +

    Returns void

    Protected createAndSetupDynamicWorkerNode

    Protected createAndSetupWorkerNode

    Protected createAndSetupWorkerNode

    Protected createWorker

    Protected createWorker

    Protected deregisterWorkerMessageListener

    Protected deregisterWorkerMessageListener

    • 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

            Returns void

      Returns void

    destroy

    Protected destroyWorkerNode

    • Terminates the worker node given its worker node key.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    destroy

    Protected destroyWorkerNode

    enableTasksQueue

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

      +

    Returns Promise<void>

    enableTasksQueue

    execute

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

      +

    Returns void

    execute

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

      • Optional transferList: TransferListItem[]

        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<Response>

      Promise that will be fulfilled when the task is completed.

      -

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    hasTaskFunction

    hasTaskFunction

    hasWorkerNodeBackPressure

    hasWorkerNodeBackPressure

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

      -

    Protected internalBusy

    Protected internalBusy

    Protected isMain

    listTaskFunctionNames

    Protected isMain

    listTaskFunctionNames

    Protected registerOnceWorkerMessageListener

    Protected registerOnceWorkerMessageListener

    • 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

            Returns void

      Returns void

    Protected registerWorkerMessageListener

    • Registers a listener callback on the worker given its worker node key.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    Protected registerWorkerMessageListener

    • 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

            Returns void

      Returns void

    removeTaskFunction

    • Removes a task function from this pool.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    removeTaskFunction

    Protected sendKillMessageToWorker

    Protected sendStartupMessageToWorker

    Protected sendKillMessageToWorker

    Protected sendStartupMessageToWorker

    Protected sendToWorker

    • Sends a message to worker given its worker node key.

      +

    Returns void

    Protected sendToWorker

    • Sends a message to worker given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

      • message: MessageValue<Data, unknown>

        The message.

      • Optional transferList: TransferListItem[]

        The optional array of transferable objects.

        -

      Returns void

    setDefaultTaskFunction

    • Sets the default task function in this pool.

      +

    Returns void

    setDefaultTaskFunction

    setTasksQueueOptions

    setTasksQueueOptions

    setWorkerChoiceStrategy

    • Sets the worker choice strategy in this pool.

      +

    Returns void

    setWorkerChoiceStrategy

    • 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

    setWorkerChoiceStrategyOptions

    • Sets the worker choice strategy options in this pool.

      +

    Returns void

    setWorkerChoiceStrategyOptions

    Protected setupHook

    • Setup hook to execute code before worker nodes are created in the abstract constructor. +

    Returns void

    Protected setupHook

    start

    Protected workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Returns void

    start

    Protected workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/classes/FixedClusterPool.html b/docs/classes/FixedClusterPool.html index b85f254c..adeeb2e4 100644 --- a/docs/classes/FixedClusterPool.html +++ b/docs/classes/FixedClusterPool.html @@ -1,9 +1,9 @@ -FixedClusterPool | poolifier - v3.0.7

    Class FixedClusterPool<Data, Response>

    A cluster pool with a fixed number of workers.

    +FixedClusterPool | poolifier - v3.0.8

    Class FixedClusterPool<Data, Response>

    A cluster pool with a fixed number of workers.

    Author

    Christopher Quadflieg

    Since

    2.0.0

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy

    Constructors

    constructor +

    Hierarchy

    Constructors

    constructor

    Properties

    emitter? filePath max? @@ -58,7 +58,7 @@

    Type Parameters

    • Data = unknown

    • Response = unknown

    Parameters

    • numberOfWorkers: number

      Number of workers for this pool.

    • filePath: string

      Path to an implementation of a ClusterWorker file, which can be relative or absolute.

    • opts: ClusterPoolOptions = {}

      Options for this fixed cluster pool.

      -

    Returns FixedClusterPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

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

    Returns FixedClusterPool<Data, Response>

    Properties

    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:

      @@ -70,109 +70,109 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • '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).
    -

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    -

    Protected Optional Readonly max

    max?: number

    Dynamic pool maximum size property placeholder.

    -

    Protected Readonly numberOfWorkers

    numberOfWorkers: number

    Number of workers that this pool should manage.

    -

    Protected Readonly opts

    opts: ClusterPoolOptions = {}

    Options for this fixed cluster pool.

    -

    Protected promiseResponseMap

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

    The task execution response promise map:

    +

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    +

    Protected Optional Readonly max

    max?: number

    Dynamic pool maximum size property placeholder.

    +

    Protected Readonly numberOfWorkers

    numberOfWorkers: number

    Number of workers that this pool should manage.

    +

    Protected Readonly opts

    opts: ClusterPoolOptions = {}

    Options for this fixed cluster pool.

    +

    Protected promiseResponseMap

    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.

    When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

    -

    Protected workerChoiceStrategyContext

    workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

    Worker choice strategy context referencing a worker choice algorithm implementation.

    -

    Readonly Internal workerNodes

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

    Pool worker nodes.

    -

    Accessors

    Protected busy

    Protected workerChoiceStrategyContext

    workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

    Worker choice strategy context referencing a worker choice algorithm implementation.

    +

    Readonly Internal workerNodes

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

    Pool worker nodes.

    +

    Accessors

    Protected busy

    • get busy(): boolean

    • Whether the pool is busy or not.

      The pool busyness boolean status.

      -

      Returns boolean

    Protected full

    Protected full

    • get full(): boolean

    • Whether the pool is full or not.

      The pool filling boolean status.

      -

      Returns boolean

    info

    Protected maxSize

    Protected minSize

    Private ready

    Protected type

    info

    Protected maxSize

    Protected minSize

    Private ready

    Protected type

    • get type(): "fixed" | "dynamic"

    • The pool type.

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

      -

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      +

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      Returns number

      The pool utilization.

      -

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      -

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    • Adds a task function to this pool. +

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      +

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    Protected afterTaskExecutionHook

    Protected afterWorkerNodeSetup

    • Method hooked up after a worker node has been newly created. +

    Returns void

    Protected afterWorkerNodeSetup

    Protected beforeTaskExecutionHook

    • Hook executed before the worker task execution. +

    Returns void

    Protected beforeTaskExecutionHook

    Protected createAndSetupDynamicWorkerNode

    • Creates a new, completely set up dynamic worker node.

      +

    Returns void

    Protected createAndSetupDynamicWorkerNode

    Protected createAndSetupWorkerNode

    Protected createAndSetupWorkerNode

    Protected createWorker

    Protected createWorker

    Protected deregisterWorkerMessageListener

    Protected deregisterWorkerMessageListener

    • 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

            Returns void

      Returns void

    destroy

    Protected destroyWorkerNode

    • Terminates the worker node given its worker node key.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    destroy

    Protected destroyWorkerNode

    enableTasksQueue

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

      +

    Returns Promise<void>

    enableTasksQueue

    execute

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

      +

    Returns void

    execute

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

      • Optional transferList: TransferListItem[]

        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<Response>

      Promise that will be fulfilled when the task is completed.

      -

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    hasTaskFunction

    hasTaskFunction

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

      -

    hasWorkerNodeBackPressure

    hasWorkerNodeBackPressure

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

      -

    Protected internalBusy

    Protected internalBusy

    Protected isMain

    listTaskFunctionNames

    Protected isMain

    listTaskFunctionNames

    Protected registerOnceWorkerMessageListener

    Protected registerOnceWorkerMessageListener

    • 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

            Returns void

      Returns void

    Protected registerWorkerMessageListener

    • Registers a listener callback on the worker given its worker node key.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    Protected registerWorkerMessageListener

    • 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

            Returns void

      Returns void

    removeTaskFunction

    • Removes a task function from this pool.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    removeTaskFunction

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

      -

    Protected sendKillMessageToWorker

    Protected sendStartupMessageToWorker

    Protected sendKillMessageToWorker

    Protected sendStartupMessageToWorker

    Protected sendToWorker

    • Sends a message to worker given its worker node key.

      +

    Returns void

    Protected sendToWorker

    setDefaultTaskFunction

    • Sets the default task function in this pool.

      +

    Returns void

    setDefaultTaskFunction

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

      -

    setTasksQueueOptions

    setTasksQueueOptions

    setWorkerChoiceStrategy

    • Sets the worker choice strategy in this pool.

      +

    Returns void

    setWorkerChoiceStrategy

    • 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

    setWorkerChoiceStrategyOptions

    • Sets the worker choice strategy options in this pool.

      +

    Returns void

    setWorkerChoiceStrategyOptions

    Protected setupHook

    • Setup hook to execute code before worker nodes are created in the abstract constructor. +

    Returns void

    Protected setupHook

    start

    Protected workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Returns void

    start

    Protected workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/classes/FixedThreadPool.html b/docs/classes/FixedThreadPool.html index 78731509..0d7ade42 100644 --- a/docs/classes/FixedThreadPool.html +++ b/docs/classes/FixedThreadPool.html @@ -1,9 +1,9 @@ -FixedThreadPool | poolifier - v3.0.7

    Class FixedThreadPool<Data, Response>

    A thread pool with a fixed number of threads.

    +FixedThreadPool | poolifier - v3.0.8

    Class FixedThreadPool<Data, Response>

    A thread pool with a fixed number of threads.

    Author

    Alessandro Pio Ardizio

    Since

    0.0.1

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy

    Constructors

    constructor +

    Hierarchy

    Constructors

    constructor

    Properties

    emitter? filePath max? @@ -58,7 +58,7 @@

    Type Parameters

    • Data = unknown

    • Response = unknown

    Parameters

    • numberOfThreads: number

      Number of threads for this pool.

    • filePath: string

      Path to an implementation of a ThreadWorker file, which can be relative or absolute.

    • opts: ThreadPoolOptions = {}

      Options for this fixed thread pool.

      -

    Returns FixedThreadPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

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

    Returns FixedThreadPool<Data, Response>

    Properties

    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:

      @@ -70,110 +70,110 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • '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).
    -

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    -

    Protected Optional Readonly max

    max?: number

    Dynamic pool maximum size property placeholder.

    -

    Protected Readonly numberOfWorkers

    numberOfWorkers: number

    Number of workers that this pool should manage.

    -

    Protected Readonly opts

    opts: ThreadPoolOptions = {}

    Options for this fixed thread pool.

    -

    Protected promiseResponseMap

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

    The task execution response promise map:

    +

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    +

    Protected Optional Readonly max

    max?: number

    Dynamic pool maximum size property placeholder.

    +

    Protected Readonly numberOfWorkers

    numberOfWorkers: number

    Number of workers that this pool should manage.

    +

    Protected Readonly opts

    opts: ThreadPoolOptions = {}

    Options for this fixed thread pool.

    +

    Protected promiseResponseMap

    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.

    When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

    -

    Protected workerChoiceStrategyContext

    workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

    Worker choice strategy context referencing a worker choice algorithm implementation.

    -

    Readonly Internal workerNodes

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

    Pool worker nodes.

    -

    Accessors

    Protected busy

    Protected workerChoiceStrategyContext

    workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

    Worker choice strategy context referencing a worker choice algorithm implementation.

    +

    Readonly Internal workerNodes

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

    Pool worker nodes.

    +

    Accessors

    Protected busy

    • get busy(): boolean

    • Whether the pool is busy or not.

      The pool busyness boolean status.

      -

      Returns boolean

    Protected full

    Protected full

    • get full(): boolean

    • Whether the pool is full or not.

      The pool filling boolean status.

      -

      Returns boolean

    info

    Protected maxSize

    Protected minSize

    Private ready

    Protected type

    info

    Protected maxSize

    Protected minSize

    Private ready

    Protected type

    • get type(): "fixed" | "dynamic"

    • The pool type.

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

      -

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      +

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      Returns number

      The pool utilization.

      -

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      -

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    • Adds a task function to this pool. +

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      +

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    Protected afterTaskExecutionHook

    Protected afterWorkerNodeSetup

    • Method hooked up after a worker node has been newly created. +

    Returns void

    Protected afterWorkerNodeSetup

    Protected beforeTaskExecutionHook

    • Hook executed before the worker task execution. +

    Returns void

    Protected beforeTaskExecutionHook

    Protected createAndSetupDynamicWorkerNode

    • Creates a new, completely set up dynamic worker node.

      +

    Returns void

    Protected createAndSetupDynamicWorkerNode

    Protected createAndSetupWorkerNode

    Protected createAndSetupWorkerNode

    Protected createWorker

    Protected createWorker

    Protected deregisterWorkerMessageListener

    Protected deregisterWorkerMessageListener

    • 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

            Returns void

      Returns void

    destroy

    Protected destroyWorkerNode

    • Terminates the worker node given its worker node key.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    destroy

    Protected destroyWorkerNode

    enableTasksQueue

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

      +

    Returns Promise<void>

    enableTasksQueue

    execute

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

      +

    Returns void

    execute

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

      • Optional transferList: TransferListItem[]

        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<Response>

      Promise that will be fulfilled when the task is completed.

      -

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    hasTaskFunction

    hasTaskFunction

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

      -

    hasWorkerNodeBackPressure

    hasWorkerNodeBackPressure

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

      -

    Protected internalBusy

    Protected internalBusy

    Protected isMain

    listTaskFunctionNames

    Protected isMain

    listTaskFunctionNames

    Protected registerOnceWorkerMessageListener

    Protected registerOnceWorkerMessageListener

    • 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

            Returns void

      Returns void

    Protected registerWorkerMessageListener

    • Registers a listener callback on the worker given its worker node key.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    Protected registerWorkerMessageListener

    • 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

            Returns void

      Returns void

    removeTaskFunction

    • Removes a task function from this pool.

      +
        • (message): void

        • Parameters

          Returns void

    Returns void

    removeTaskFunction

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

      -

    Protected sendKillMessageToWorker

    Protected sendStartupMessageToWorker

    Protected sendKillMessageToWorker

    Protected sendStartupMessageToWorker

    Protected sendToWorker

    • Sends a message to worker given its worker node key.

      +

    Returns void

    Protected sendToWorker

    • Sends a message to worker given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

      • message: MessageValue<Data, unknown>

        The message.

      • Optional transferList: TransferListItem[]

        The optional array of transferable objects.

        -

      Returns void

    setDefaultTaskFunction

    • Sets the default task function in this pool.

      +

    Returns void

    setDefaultTaskFunction

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

      -

    setTasksQueueOptions

    setTasksQueueOptions

    setWorkerChoiceStrategy

    • Sets the worker choice strategy in this pool.

      +

    Returns void

    setWorkerChoiceStrategy

    • 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

    setWorkerChoiceStrategyOptions

    • Sets the worker choice strategy options in this pool.

      +

    Returns void

    setWorkerChoiceStrategyOptions

    Protected setupHook

    • Setup hook to execute code before worker nodes are created in the abstract constructor. +

    Returns void

    Protected setupHook

    start

    Protected workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Returns void

    start

    Protected workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/classes/Node.html b/docs/classes/Node.html index 7b1b8314..93e2e6be 100644 --- a/docs/classes/Node.html +++ b/docs/classes/Node.html @@ -1,7 +1,7 @@ -Node | poolifier - v3.0.7

    Class Node<T>Internal

    Node.

    +Node | poolifier - v3.0.8

    Class Node<T>Internal

    Node.

    Type Parameters

    • T

      Type of node data.

      -

    Hierarchy

    • Node

    Constructors

    constructor +

    Hierarchy

    • Node

    Constructors

    constructor

    Properties

    data next? prev? -

    Constructors

    constructor

    Properties

    data

    data: T

    Optional next

    next?: Node<T>

    Optional prev

    prev?: Node<T>

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Constructors

    constructor

    Properties

    data

    data: T

    Optional next

    next?: Node<T>

    Optional prev

    prev?: Node<T>

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/classes/ThreadWorker.html b/docs/classes/ThreadWorker.html index 78fb7b7b..681cafd6 100644 --- a/docs/classes/ThreadWorker.html +++ b/docs/classes/ThreadWorker.html @@ -1,4 +1,4 @@ -ThreadWorker | poolifier - v3.0.7

    Class ThreadWorker<Data, Response>

    A thread worker used by a poolifier ThreadPool.

    +ThreadWorker | poolifier - v3.0.8

    Class ThreadWorker<Data, Response>

    A thread worker used by a poolifier ThreadPool.

    When this worker is inactive for more than the given maxInactiveTime, it will send a termination request to its main thread.

    If you use a DynamicThreadPool the extra workers that were created will be terminated, @@ -7,7 +7,7 @@ but the minimum number of workers will be guaranteed.

    Since

    0.0.1

    Type Parameters

    • Data = unknown

      Type of data this worker receives from pool's execution. This can only be structured-cloneable data.

    • Response = unknown

      Type of response the worker sends back to the main thread. This can only be structured-cloneable data.

      -

    Hierarchy

    Constructors

    constructor +

    Hierarchy

    Constructors

    constructor

    Properties

    activeInterval? isMain lastTaskTimestamp @@ -41,20 +41,20 @@ but the minimum number of workers will be guaranteed.

    Constructors

    constructor

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    -

    Protected Readonly isMain

    isMain: boolean

    Whether this is the main worker or not.

    -

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    -

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -

    Private port

    port: MessagePort

    Message port used to communicate with the main worker.

    -

    Protected statistics

    statistics: WorkerStatistics

    Performance statistics computation requirements.

    -

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunction<Data, Response>>

    Task function(s) processed by the worker when the pool's execution function is invoked.

    -

    Accessors

    Protected id

    Methods

    addTaskFunction

    Returns ThreadWorker<Data, Response>

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    +

    Protected Readonly isMain

    isMain: boolean

    Whether this is the main worker or not.

    +

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    +

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    +

    Private port

    port: MessagePort

    Message port used to communicate with the main worker.

    +

    Protected statistics

    statistics: WorkerStatistics

    Performance statistics computation requirements.

    +

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunction<Data, Response>>

    Task function(s) processed by the worker when the pool's execution function is invoked.

    +

    Accessors

    Protected id

    Methods

    addTaskFunction

    asyncId

    asyncId

    • Returns number

      The unique asyncId assigned to the resource.

    bind

    • Binds the given function to execute to this AsyncResource's scope.

      Type Parameters

      • Func extends ((...args) => any)

      Parameters

      • fn: Func

        The function to bind to the current AsyncResource.

      Returns Func

      Since

      v14.8.0, v12.19.0

      @@ -66,28 +66,28 @@ never be called.

    Protected getMainWorker

    Protected handleError

    Protected handleError

    • Handles an error and convert it to a string so it can be sent back to the main worker.

      Parameters

      • error: string | Error

        The error raised by the worker.

      Returns string

      The error message.

      -

    Protected handleKillMessage

    Protected handleReadyMessage

    Protected handleKillMessage

    Protected handleReadyMessage

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    Returns void

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    listTaskFunctionNames

    listTaskFunctionNames

    Protected messageListener

    Protected messageListener

    removeTaskFunction

    Returns void

    removeTaskFunction

    Protected run

    Protected run

    Protected runAsync

    • Runs the given task function asynchronously.

      +

    Returns void

    Protected runAsync

    runInAsyncScope

    • Call the provided function with the provided arguments in the execution context +

    Returns void

    runInAsyncScope

    • Call the provided function with the provided arguments in the execution context of the async resource. This will establish the context, trigger the AsyncHooks before callbacks, call the function, trigger the AsyncHooks after callbacks, and then restore the original execution context.

      @@ -98,15 +98,15 @@ then restore the original execution context.

    Protected runSync

    Protected sendTaskFunctionNamesToMainWorker

    Protected sendToMainWorker

    • Sends a message to main worker.

      +

    Returns void

    Protected sendTaskFunctionNamesToMainWorker

    Protected sendToMainWorker

    setDefaultTaskFunction

    Returns void

    setDefaultTaskFunction

    triggerAsyncId

    triggerAsyncId

    • Returns number

      The same triggerAsyncId that is passed to the AsyncResource constructor.

    Static bind

    • Binds the given function to the current execution context.

      Type Parameters

      • Func extends ((this, ...args) => any)

      • ThisArg

      Parameters

      • fn: Func

        The function to bind to the current execution context.

      • Optional type: string

        An optional name to associate with the underlying AsyncResource.

      • Optional thisArg: ThisArg

      Returns Func

      Since

      v14.8.0, v12.19.0

      -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/classes/WorkerChoiceStrategyContext.html b/docs/classes/WorkerChoiceStrategyContext.html index 66215832..5614ab22 100644 --- a/docs/classes/WorkerChoiceStrategyContext.html +++ b/docs/classes/WorkerChoiceStrategyContext.html @@ -1,8 +1,8 @@ -WorkerChoiceStrategyContext | poolifier - v3.0.7

    Class WorkerChoiceStrategyContext<Worker, Data, Response>

    The worker choice strategy context.

    +WorkerChoiceStrategyContext | poolifier - v3.0.8

    Class WorkerChoiceStrategyContext<Worker, Data, Response>

    The worker choice strategy context.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy

    • WorkerChoiceStrategyContext

    Constructors

    constructor +

    Hierarchy

    • WorkerChoiceStrategyContext

    Constructors

    constructor

    Properties

    opts retriesCount workerChoiceStrategies @@ -18,23 +18,23 @@

    Type Parameters

    • Worker extends IWorker

    • Data = unknown

    • Response = unknown

    Parameters

    • pool: IPool<Worker, Data, Response>

      The pool instance.

    • workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN" = WorkerChoiceStrategies.ROUND_ROBIN

      The worker choice strategy.

    • opts: WorkerChoiceStrategyOptions = DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS

      The worker choice strategy options.

      -

    Returns WorkerChoiceStrategyContext<Worker, Data, Response>

    Properties

    Private opts

    opts: WorkerChoiceStrategyOptions = DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS

    The worker choice strategy options.

    -

    Private retriesCount

    retriesCount: number = 0

    The number of times the worker choice strategy in the context has been retried.

    -

    Private Readonly workerChoiceStrategies

    workerChoiceStrategies: Map<"ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN", IWorkerChoiceStrategy>

    Private workerChoiceStrategy

    workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN" = WorkerChoiceStrategies.ROUND_ROBIN

    The worker choice strategy.

    -

    Methods

    execute

    • Executes the worker choice strategy in the context algorithm.

      +

    Returns WorkerChoiceStrategyContext<Worker, Data, Response>

    Properties

    Private opts

    opts: WorkerChoiceStrategyOptions = DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS

    The worker choice strategy options.

    +

    Private retriesCount

    retriesCount: number = 0

    The number of times the worker choice strategy in the context has been retried.

    +

    Private Readonly workerChoiceStrategies

    workerChoiceStrategies: Map<"ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN", IWorkerChoiceStrategy>

    Private workerChoiceStrategy

    workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN" = WorkerChoiceStrategies.ROUND_ROBIN

    The worker choice strategy.

    +

    Methods

    execute

    getStrategyPolicy

    getStrategyPolicy

    getTaskStatisticsRequirements

    getTaskStatisticsRequirements

    remove

    remove

    setOptions

    setOptions

    setWorkerChoiceStrategy

    • Sets the worker choice strategy to use in the context.

      +

    Returns void

    setWorkerChoiceStrategy

    • Sets the worker choice strategy to use in the context.

      Parameters

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

        The worker choice strategy to set.

        -

      Returns void

    update

    • Updates the worker node key in the worker choice strategy in the context internals.

      +

    Returns void

    update

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/functions/availableParallelism.html b/docs/functions/availableParallelism.html index 43176019..234e9402 100644 --- a/docs/functions/availableParallelism.html +++ b/docs/functions/availableParallelism.html @@ -1,4 +1,4 @@ -availableParallelism | poolifier - v3.0.7

    Function availableParallelism

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/index.html b/docs/index.html index faf16831..0fbeb09f 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,4 +1,4 @@ -poolifier - v3.0.7

    poolifier - v3.0.7

    Index

    Classes

    AbstractPool +poolifier - v3.0.8

    poolifier - v3.0.8

    Index

    Classes

    AbstractPool AbstractWorker CircularArray ClusterWorker @@ -62,4 +62,4 @@ WorkerChoiceStrategies WorkerTypes

    Functions

    availableParallelism -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/ClusterPoolOptions.html b/docs/interfaces/ClusterPoolOptions.html index ea3a7b6c..c5f2a6de 100644 --- a/docs/interfaces/ClusterPoolOptions.html +++ b/docs/interfaces/ClusterPoolOptions.html @@ -1,5 +1,5 @@ -ClusterPoolOptions | poolifier - v3.0.7

    Interface ClusterPoolOptions

    Options for a poolifier cluster pool.

    -

    Hierarchy

    Properties

    enableEvents? +ClusterPoolOptions | poolifier - v3.0.8

    Interface ClusterPoolOptions

    Options for a poolifier cluster pool.

    +

    Hierarchy

    Properties

    enableEvents? enableTasksQueue? env? errorHandler? @@ -15,28 +15,28 @@

    Properties

    Optional enableEvents

    enableEvents?: boolean

    Pool events integrated with async resource emission.

    Default Value

    true
    -

    Optional enableTasksQueue

    enableTasksQueue?: boolean

    Pool worker node tasks queue.

    +

    Optional enableTasksQueue

    enableTasksQueue?: boolean

    Pool worker node tasks queue.

    Default Value

    false
    -

    Optional env

    env?: Record<string, unknown>

    Key/value pairs to add to worker process environment.

    +

    Optional env

    env?: Record<string, unknown>

    Key/value pairs to add to worker process environment.

    See

    https://nodejs.org/api/cluster.html#cluster_cluster_fork_env

    -

    Optional errorHandler

    errorHandler?: ErrorHandler<Worker>

    A function that will listen for error event on each worker.

    +

    Optional errorHandler

    errorHandler?: ErrorHandler<Worker>

    A function that will listen for error event on each worker.

    Default Value

    () => {}

    -

    Optional exitHandler

    exitHandler?: ExitHandler<Worker>

    A function that will listen for exit event on each worker.

    +

    Optional exitHandler

    exitHandler?: ExitHandler<Worker>

    A function that will listen for exit event on each worker.

    Default Value

    () => {}

    -

    Optional messageHandler

    messageHandler?: MessageHandler<Worker>

    A function that will listen for message event on each worker.

    +

    Optional messageHandler

    messageHandler?: MessageHandler<Worker>

    A function that will listen for message event on each worker.

    Default Value

    () => {}

    -

    Optional onlineHandler

    onlineHandler?: OnlineHandler<Worker>

    A function that will listen for online event on each worker.

    +

    Optional onlineHandler

    onlineHandler?: OnlineHandler<Worker>

    A function that will listen for online event on each worker.

    Default Value

    () => {}

    -

    Optional restartWorkerOnError

    restartWorkerOnError?: boolean

    Restart worker on error.

    -

    Optional settings

    settings?: ClusterSettings

    Cluster settings.

    +

    Optional restartWorkerOnError

    restartWorkerOnError?: boolean

    Restart worker on error.

    +

    Optional settings

    settings?: ClusterSettings

    Cluster settings.

    See

    https://nodejs.org/api/cluster.html#cluster_cluster_settings

    -

    Optional startWorkers

    startWorkers?: boolean

    Whether to start the minimum number of workers at pool initialization.

    +

    Optional startWorkers

    startWorkers?: boolean

    Whether to start the minimum number of workers at pool initialization.

    Default Value

    true
    -

    Optional tasksQueueOptions

    tasksQueueOptions?: TasksQueueOptions

    Pool worker node tasks queue options.

    -

    Optional workerChoiceStrategy

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

    The worker choice strategy to use in this pool.

    +

    Optional tasksQueueOptions

    tasksQueueOptions?: TasksQueueOptions

    Pool worker node tasks queue options.

    +

    Optional workerChoiceStrategy

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

    The worker choice strategy to use in this pool.

    Default Value

    WorkerChoiceStrategies.ROUND_ROBIN
    -

    Optional workerChoiceStrategyOptions

    workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Optional workerChoiceStrategyOptions

    workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html b/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html index 13b8bf80..89e28158 100644 --- a/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html +++ b/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html @@ -1,5 +1,5 @@ -EventLoopUtilizationMeasurementStatistics | poolifier - v3.0.7

    Interface EventLoopUtilizationMeasurementStatisticsInternal

    Event loop utilization measurement statistics.

    -

    Hierarchy

    • EventLoopUtilizationMeasurementStatistics

    Properties

    active +EventLoopUtilizationMeasurementStatistics | poolifier - v3.0.8

    Interface EventLoopUtilizationMeasurementStatisticsInternal

    Event loop utilization measurement statistics.

    +

    Hierarchy

    • EventLoopUtilizationMeasurementStatistics

    Properties

    active idle utilization? -

    Properties

    Readonly active

    active: MeasurementStatistics

    Readonly idle

    idle: MeasurementStatistics

    Optional utilization

    utilization?: number

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    Readonly active

    active: MeasurementStatistics

    Readonly idle

    idle: MeasurementStatistics

    Optional utilization

    utilization?: number

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/IPool.html b/docs/interfaces/IPool.html index 8266d6e2..ed9683f3 100644 --- a/docs/interfaces/IPool.html +++ b/docs/interfaces/IPool.html @@ -1,8 +1,8 @@ -IPool | poolifier - v3.0.7

    Interface IPool<Worker, Data, Response>

    Contract definition for a poolifier pool.

    +IPool | poolifier - v3.0.8

    Interface IPool<Worker, Data, Response>

    Contract definition for a poolifier pool.

    Type Parameters

    • Worker extends IWorker

      Type of worker which manages this pool.

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy

    • IPool

    Implemented by

    Properties

    addTaskFunction +

    Hierarchy

    • IPool

    Implemented by

    Properties

    addTaskFunction destroy emitter? enableTasksQueue @@ -25,8 +25,8 @@ If a task function with the same name already exists, it will be overwritten.

    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.

    -

    Readonly destroy

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

    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. +

    Readonly destroy

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

    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. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -38,36 +38,36 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • '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)

    Type declaration

      • (enable, tasksQueueOptions?): void

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

        +

    Readonly enableTasksQueue

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

    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

    Readonly execute

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

    Type declaration

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

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

        +

    Returns void

    Readonly execute

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

    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.

        • Optional transferList: TransferListItem[]

          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<Response>

        Promise that will be fulfilled when the task is completed.

        -

    Readonly hasTaskFunction

    hasTaskFunction: ((name) => boolean)

    Type declaration

      • (name): boolean

      • Whether the specified task function exists in this pool.

        +

    Readonly hasTaskFunction

    hasTaskFunction: ((name) => boolean)

    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.

        -

    Readonly hasWorkerNodeBackPressure

    hasWorkerNodeBackPressure: ((workerNodeKey) => boolean)

    Type declaration

      • (workerNodeKey): boolean
      • Internal

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

        +

    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 listTaskFunctionNames

    listTaskFunctionNames: (() => string[])

    Type declaration

      • (): string[]

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

        +

    Readonly info

    info: PoolInfo

    Pool information.

    +

    Readonly listTaskFunctionNames

    listTaskFunctionNames: (() => 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.

        -

    Readonly removeTaskFunction

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

    Type declaration

      • (name): Promise<boolean>

      • Removes a task function from this pool.

        +

    Readonly removeTaskFunction

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

    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.

        -

    Readonly setDefaultTaskFunction

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

    Type declaration

      • (name): Promise<boolean>

      • Sets the default task function in this pool.

        +

    Readonly setDefaultTaskFunction

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

    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.

        -

    Readonly setTasksQueueOptions

    setTasksQueueOptions: ((tasksQueueOptions) => void)

    Type declaration

      • (tasksQueueOptions): void

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

        +

    Readonly setTasksQueueOptions

    setTasksQueueOptions: ((tasksQueueOptions) => void)

    Type declaration

      • (tasksQueueOptions): void

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

        Parameters

        Returns void

    Readonly setWorkerChoiceStrategy

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

    Type declaration

      • (workerChoiceStrategy, workerChoiceStrategyOptions?): void

      • Sets the worker choice strategy in this pool.

        +

    Returns void

    Readonly setWorkerChoiceStrategy

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

    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

    Readonly setWorkerChoiceStrategyOptions

    setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions) => void)

    Type declaration

      • (workerChoiceStrategyOptions): void

      • Sets the worker choice strategy options in this pool.

        +

    Returns void

    Readonly setWorkerChoiceStrategyOptions

    setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions) => void)

    Type declaration

      • (workerChoiceStrategyOptions): void

      • Sets the worker choice strategy options in this pool.

        Parameters

        Returns void

    Readonly start

    start: (() => void)

    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 +

    Returns void

    Readonly start

    start: (() => void)

    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 diff --git a/docs/interfaces/IWorker.html b/docs/interfaces/IWorker.html index 7e8bbfcd..8d9e90cd 100644 --- a/docs/interfaces/IWorker.html +++ b/docs/interfaces/IWorker.html @@ -1,13 +1,13 @@ -IWorker | poolifier - v3.0.7

    Interface IWorker

    Worker interface.

    -

    Hierarchy

    • IWorker

    Properties

    id? +IWorker | poolifier - v3.0.8

    Interface IWorker

    Worker interface.

    +

    Hierarchy

    • IWorker

    Properties

    id? on once threadId?

    Properties

    Optional Readonly id

    id?: number

    Worker id.

    -

    Readonly on

    on: ((event, handler) => void) & ((event, handler) => void) & ((event, handler) => void) & ((event, handler) => void)

    Registers an event listener.

    +

    Readonly on

    on: ((event, handler) => void) & ((event, handler) => void) & ((event, handler) => void) & ((event, handler) => void)

    Registers an event listener.

    Type declaration

    Type declaration

    Type declaration

    Type declaration

    Param

    The event.

    Param

    The event handler.

    -

    Readonly once

    once: ((event, handler) => void)

    Type declaration

      • (event, handler): void

      • Registers a listener to the exit event that will only be performed once.

        +

    Readonly once

    once: ((event, handler) => void)

    Type declaration

      • (event, handler): void

      • Registers a listener to the exit event that will only be performed once.

        Parameters

        Returns void

    Optional Readonly threadId

    threadId?: number

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Returns void

    Optional Readonly threadId

    threadId?: number

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/IWorkerChoiceStrategy.html b/docs/interfaces/IWorkerChoiceStrategy.html index 4a0588fc..ea738724 100644 --- a/docs/interfaces/IWorkerChoiceStrategy.html +++ b/docs/interfaces/IWorkerChoiceStrategy.html @@ -1,5 +1,5 @@ -IWorkerChoiceStrategy | poolifier - v3.0.7

    Interface IWorkerChoiceStrategyInternal

    Worker choice strategy interface.

    -

    Hierarchy

    • IWorkerChoiceStrategy

    Properties

    choose +IWorkerChoiceStrategy | poolifier - v3.0.8

    Interface IWorkerChoiceStrategyInternal

    Worker choice strategy interface.

    +

    Hierarchy

    • IWorkerChoiceStrategy

    Properties

    choose remove reset setOptions @@ -10,16 +10,16 @@ If no worker nodes are not eligible, undefined is returned. If undefined is returned, the caller retry.

    Returns undefined | number

    The worker node key or undefined.

    -

    Readonly remove

    remove: ((workerNodeKey) => boolean)

    Type declaration

      • (workerNodeKey): boolean

      • Removes the worker node key from strategy internals.

        +

    Readonly remove

    remove: ((workerNodeKey) => boolean)

    Type declaration

      • (workerNodeKey): boolean

      • Removes the worker node key from strategy internals.

        Parameters

        • workerNodeKey: number

          The worker node key.

        Returns boolean

        true if the worker node key is removed, false otherwise.

        -

    Readonly reset

    reset: (() => boolean)

    Type declaration

      • (): boolean

      • Resets strategy internals.

        +

    Readonly reset

    reset: (() => boolean)

    Type declaration

      • (): boolean

      • Resets strategy internals.

        Returns boolean

        true if the reset is successful, false otherwise.

        -

    Readonly setOptions

    setOptions: ((opts) => void)

    Type declaration

      • (opts): void

      • Sets the worker choice strategy options.

        +

    Readonly setOptions

    setOptions: ((opts) => void)

    Type declaration

      • (opts): void

      • Sets the worker choice strategy options.

        Parameters

        Returns void

    Readonly strategyPolicy

    strategyPolicy: StrategyPolicy

    Strategy policy.

    -

    Readonly taskStatisticsRequirements

    taskStatisticsRequirements: TaskStatisticsRequirements

    Tasks statistics requirements.

    -

    Readonly update

    update: ((workerNodeKey) => boolean)

    Type declaration

      • (workerNodeKey): boolean

      • Updates the worker node key strategy internals. +

    Returns void

    Readonly strategyPolicy

    strategyPolicy: StrategyPolicy

    Strategy policy.

    +

    Readonly taskStatisticsRequirements

    taskStatisticsRequirements: TaskStatisticsRequirements

    Tasks statistics requirements.

    +

    Readonly update

    update: ((workerNodeKey) => boolean)

    Type declaration

      • (workerNodeKey): boolean

      • Updates the worker node key strategy internals. This is called after a task has been executed on a worker node.

        Parameters

        • workerNodeKey: number

        Returns boolean

        true if the update is successful, false otherwise.

        -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/IWorkerNode.html b/docs/interfaces/IWorkerNode.html index f07ef490..1f38e383 100644 --- a/docs/interfaces/IWorkerNode.html +++ b/docs/interfaces/IWorkerNode.html @@ -1,7 +1,7 @@ -IWorkerNode | poolifier - v3.0.7

    Interface IWorkerNode<Worker, Data>Internal

    Worker node interface.

    +IWorkerNode | poolifier - v3.0.8

    Interface IWorkerNode<Worker, Data>Internal

    Worker node interface.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

      -

    Hierarchy

    • EventTarget
      • IWorkerNode

    Properties

    clearTasksQueue +

    Hierarchy

    • EventEmitter
      • IWorkerNode

    Properties

    clearTasksQueue closeChannel deleteTaskFunctionWorkerUsage dequeueTask @@ -18,50 +18,164 @@ unshiftTask usage worker -

    Methods

    addEventListener -dispatchEvent -removeEventListener +

    Methods

    [captureRejectionSymbol]? +addListener +emit +eventNames +getMaxListeners +listenerCount +listeners +off +on +once +prependListener +prependOnceListener +rawListeners +removeAllListeners +removeListener +setMaxListeners

    Properties

    Readonly clearTasksQueue

    clearTasksQueue: (() => void)

    Type declaration

      • (): void

      • Clears tasks queue.

        -

        Returns void

    Readonly closeChannel

    closeChannel: (() => void)

    Type declaration

      • (): void

      • Closes communication channel.

        -

        Returns void

    Readonly deleteTaskFunctionWorkerUsage

    deleteTaskFunctionWorkerUsage: ((name) => boolean)

    Type declaration

      • (name): boolean

      • Deletes task function worker usage statistics.

        +

        Returns void

    Readonly closeChannel

    closeChannel: (() => void)

    Type declaration

      • (): void

      • Closes communication channel.

        +

        Returns void

    Readonly deleteTaskFunctionWorkerUsage

    deleteTaskFunctionWorkerUsage: ((name) => boolean)

    Type declaration

      • (name): boolean

      • Deletes task function worker usage statistics.

        Parameters

        • name: string

          The task function name.

        Returns boolean

        true if the task function worker usage statistics were deleted, false otherwise.

        -

    Readonly dequeueTask

    dequeueTask: (() => undefined | Task<Data>)

    Type declaration

      • (): undefined | Task<Data>

      • Dequeue task.

        +

    Readonly dequeueTask

    dequeueTask: (() => undefined | Task<Data>)

    Type declaration

      • (): undefined | Task<Data>

      • Dequeue task.

        Returns undefined | Task<Data>

        The dequeued task.

        -

    Readonly enqueueTask

    enqueueTask: ((task) => number)

    Type declaration

      • (task): number

      • Enqueue task.

        +

    Readonly enqueueTask

    enqueueTask: ((task) => number)

    Type declaration

      • (task): number

      • Enqueue task.

        Parameters

        • task: Task<Data>

          The task to queue.

        Returns number

        The tasks queue size.

        -

    Readonly getTaskFunctionWorkerUsage

    getTaskFunctionWorkerUsage: ((name) => undefined | WorkerUsage)

    Type declaration

      • (name): undefined | WorkerUsage

      • Gets task function worker usage statistics.

        +

    Readonly getTaskFunctionWorkerUsage

    getTaskFunctionWorkerUsage: ((name) => undefined | WorkerUsage)

    Type declaration

      • (name): undefined | WorkerUsage

      • Gets task function worker usage statistics.

        Parameters

        • name: string

          The task function name.

        Returns undefined | WorkerUsage

        The task function worker usage statistics if the task function worker usage statistics are initialized, undefined otherwise.

        -

    Readonly hasBackPressure

    hasBackPressure: (() => boolean)

    Type declaration

      • (): boolean

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

        +

    Readonly hasBackPressure

    hasBackPressure: (() => boolean)

    Type declaration

      • (): boolean

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

        Returns boolean

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

        -

    Readonly info

    info: WorkerInfo

    Worker info.

    -

    Optional Readonly messageChannel

    messageChannel?: MessageChannel

    Message channel (worker_threads only).

    -

    Readonly popTask

    popTask: (() => undefined | Task<Data>)

    Type declaration

      • (): undefined | Task<Data>

      • Pops a task from the tasks queue.

        +

    Readonly info

    info: WorkerInfo

    Worker info.

    +

    Optional Readonly messageChannel

    messageChannel?: MessageChannel

    Message channel (worker_threads only).

    +

    Readonly popTask

    popTask: (() => undefined | Task<Data>)

    Type declaration

      • (): undefined | Task<Data>

      • Pops a task from the tasks queue.

        Returns undefined | Task<Data>

        The popped task.

        -

    Readonly resetUsage

    resetUsage: (() => void)

    Type declaration

      • (): void

      • Resets usage statistics.

        -

        Returns void

    Optional strategyData

    strategyData?: StrategyData

    Worker choice strategy data. +

    Readonly resetUsage

    resetUsage: (() => void)

    Type declaration

      • (): void

      • Resets usage statistics.

        +

        Returns void

    Optional strategyData

    strategyData?: StrategyData

    Worker choice strategy data. This is used to store data that are specific to the worker choice strategy.

    -

    tasksQueueBackPressureSize

    tasksQueueBackPressureSize: number

    Tasks queue back pressure size. +

    tasksQueueBackPressureSize

    tasksQueueBackPressureSize: number

    Tasks queue back pressure size. This is the number of tasks that can be enqueued before the worker node has back pressure.

    -

    Readonly tasksQueueSize

    tasksQueueSize: (() => number)

    Type declaration

    Readonly tasksQueueSize

    tasksQueueSize: (() => number)

    Type declaration

      • (): number

      • Tasks queue size.

        Returns number

        The tasks queue size.

        -

    Readonly unshiftTask

    unshiftTask: ((task) => number)

    Type declaration

      • (task): number

      • Prepends a task to the tasks queue.

        +

    Readonly unshiftTask

    unshiftTask: ((task) => number)

    Type declaration

      • (task): number

      • Prepends a task to the tasks queue.

        Parameters

        • task: Task<Data>

          The task to prepend.

        Returns number

        The tasks queue size.

        -

    Readonly usage

    usage: WorkerUsage

    Worker usage statistics.

    -

    Readonly worker

    worker: Worker

    Worker.

    -

    Methods

    addEventListener

    • Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.

      -

      The options argument sets listener-specific options. For compatibility this can be a boolean, in which case the method behaves exactly as if the value was specified as options's capture.

      -

      When set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET.

      -

      When set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in § 2.8 Observing event listeners.

      -

      When set to true, options's once indicates that the callback will only be invoked once after which the event listener will be removed.

      -

      If an AbortSignal is passed for options's signal, then the event listener will be removed when signal is aborted.

      -

      The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.

      -

      MDN Reference

      -

      Parameters

      • type: string
      • callback: null | EventListenerOrEventListenerObject
      • Optional options: boolean | AddEventListenerOptions

      Returns void

    dispatchEvent

    • Dispatches a synthetic event event to target and returns true if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise.

      -

      MDN Reference

      -

      Parameters

      • event: Event

      Returns boolean

    removeEventListener

    • Removes the event listener in target's event listener list with the same type, callback, and options.

      -

      MDN Reference

      -

      Parameters

      • type: string
      • callback: null | EventListenerOrEventListenerObject
      • Optional options: boolean | EventListenerOptions

      Returns void

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Readonly usage

    usage: WorkerUsage

    Worker usage statistics.

    +

    Readonly worker

    worker: Worker

    Worker.

    +

    Methods

    Optional [captureRejectionSymbol]

    • [captureRejectionSymbol](error, event, ...args): void

    • Parameters

      • error: Error
      • event: string
      • Rest ...args: any[]

      Returns void

    addListener

    • Alias for emitter.on(eventName, listener).

      +

      Parameters

      • eventName: string | symbol
      • listener: ((...args) => void)
          • (...args): void

          • Parameters

            • Rest ...args: any[]

            Returns void

      Returns IWorkerNode<Worker, Data>

      Since

      v0.1.26

      +

    emit

    • Synchronously calls each of the listeners registered for the event namedeventName, in the order they were registered, passing the supplied arguments +to each.

      +

      Returns true if the event had listeners, false otherwise.

      +
      import { EventEmitter } from 'node:events';
      const myEmitter = new EventEmitter();

      // First listener
      myEmitter.on('event', function firstListener() {
        console.log('Helloooo! first listener');
      });
      // Second listener
      myEmitter.on('event', function secondListener(arg1, arg2) {
        console.log(`event with parameters ${arg1}, ${arg2} in second listener`);
      });
      // Third listener
      myEmitter.on('event', function thirdListener(...args) {
        const parameters = args.join(', ');
        console.log(`event with parameters ${parameters} in third listener`);
      });

      console.log(myEmitter.listeners('event'));

      myEmitter.emit('event', 1, 2, 3, 4, 5);

      // Prints:
      // [
      //   [Function: firstListener],
      //   [Function: secondListener],
      //   [Function: thirdListener]
      // ]
      // Helloooo! first listener
      // event with parameters 1, 2 in second listener
      // event with parameters 1, 2, 3, 4, 5 in third listener
+
      +

      Parameters

      • eventName: string | symbol
      • Rest ...args: any[]

      Returns boolean

      Since

      v0.1.26

      +

    eventNames

    • Returns an array listing the events for which the emitter has registered +listeners. The values in the array are strings or Symbols.

      +
      import { EventEmitter } from 'node:events';

      const myEE = new EventEmitter();
      myEE.on('foo', () => {});
      myEE.on('bar', () => {});

      const sym = Symbol('symbol');
      myEE.on(sym, () => {});

      console.log(myEE.eventNames());
      // Prints: [ 'foo', 'bar', Symbol(symbol) ]
+
      +

      Returns (string | symbol)[]

      Since

      v6.0.0

      +

    getMaxListeners

    • Returns the current max listener value for the EventEmitter which is either +set by emitter.setMaxListeners(n) or defaults to defaultMaxListeners.

      +

      Returns number

      Since

      v1.0.0

      +

    listenerCount

    • Returns the number of listeners listening for the event named eventName. +If listener is provided, it will return how many times the listener is found +in the list of the listeners of the event.

      +

      Parameters

      • eventName: string | symbol

        The name of the event being listened for

        +
      • Optional listener: Function

        The event handler function

        +

      Returns number

      Since

      v3.2.0

      +

    listeners

    • Returns a copy of the array of listeners for the event named eventName.

      +
      server.on('connection', (stream) => {
        console.log('someone connected!');
      });
      console.log(util.inspect(server.listeners('connection')));
      // Prints: [ [Function] ]
+
      +

      Parameters

      • eventName: string | symbol

      Returns Function[]

      Since

      v0.1.26

      +

    off

    • Alias for emitter.removeListener().

      +

      Parameters

      • eventName: string | symbol
      • listener: ((...args) => void)
          • (...args): void

          • Parameters

            • Rest ...args: any[]

            Returns void

      Returns IWorkerNode<Worker, Data>

      Since

      v10.0.0

      +

    on

    • Adds the listener function to the end of the listeners array for the +event named eventName. No checks are made to see if the listener has +already been added. Multiple calls passing the same combination of eventNameand listener will result in the listener being added, and called, multiple +times.

      +
      server.on('connection', (stream) => {
        console.log('someone connected!');
      });
+
      +

      Returns a reference to the EventEmitter, so that calls can be chained.

      +

      By default, event listeners are invoked in the order they are added. Theemitter.prependListener() method can be used as an alternative to add the +event listener to the beginning of the listeners array.

      +
      import { EventEmitter } from 'node:events';
      const myEE = new EventEmitter();
      myEE.on('foo', () => console.log('a'));
      myEE.prependListener('foo', () => console.log('b'));
      myEE.emit('foo');
      // Prints:
      //   b
      //   a
+
      +

      Parameters

      • eventName: string | symbol

        The name of the event.

        +
      • listener: ((...args) => void)

        The callback function

        +
          • (...args): void

          • Parameters

            • Rest ...args: any[]

            Returns void

      Returns IWorkerNode<Worker, Data>

      Since

      v0.1.101

      +

    once

    • Adds a one-timelistener function for the event named eventName. The +next time eventName is triggered, this listener is removed and then invoked.

      +
      server.once('connection', (stream) => {
        console.log('Ah, we have our first user!');
      });
+
      +

      Returns a reference to the EventEmitter, so that calls can be chained.

      +

      By default, event listeners are invoked in the order they are added. Theemitter.prependOnceListener() method can be used as an alternative to add the +event listener to the beginning of the listeners array.

      +
      import { EventEmitter } from 'node:events';
      const myEE = new EventEmitter();
      myEE.once('foo', () => console.log('a'));
      myEE.prependOnceListener('foo', () => console.log('b'));
      myEE.emit('foo');
      // Prints:
      //   b
      //   a
+
      +

      Parameters

      • eventName: string | symbol

        The name of the event.

        +
      • listener: ((...args) => void)

        The callback function

        +
          • (...args): void

          • Parameters

            • Rest ...args: any[]

            Returns void

      Returns IWorkerNode<Worker, Data>

      Since

      v0.3.0

      +

    prependListener

    • Adds the listener function to the beginning of the listeners array for the +event named eventName. No checks are made to see if the listener has +already been added. Multiple calls passing the same combination of eventNameand listener will result in the listener being added, and called, multiple +times.

      +
      server.prependListener('connection', (stream) => {
        console.log('someone connected!');
      });
+
      +

      Returns a reference to the EventEmitter, so that calls can be chained.

      +

      Parameters

      • eventName: string | symbol

        The name of the event.

        +
      • listener: ((...args) => void)

        The callback function

        +
          • (...args): void

          • Parameters

            • Rest ...args: any[]

            Returns void

      Returns IWorkerNode<Worker, Data>

      Since

      v6.0.0

      +

    prependOnceListener

    • Adds a one-timelistener function for the event named eventName to the beginning of the listeners array. The next time eventName is triggered, this +listener is removed, and then invoked.

      +
      server.prependOnceListener('connection', (stream) => {
        console.log('Ah, we have our first user!');
      });
+
      +

      Returns a reference to the EventEmitter, so that calls can be chained.

      +

      Parameters

      • eventName: string | symbol

        The name of the event.

        +
      • listener: ((...args) => void)

        The callback function

        +
          • (...args): void

          • Parameters

            • Rest ...args: any[]

            Returns void

      Returns IWorkerNode<Worker, Data>

      Since

      v6.0.0

      +

    rawListeners

    • Returns a copy of the array of listeners for the event named eventName, +including any wrappers (such as those created by .once()).

      +
      import { EventEmitter } from 'node:events';
      const emitter = new EventEmitter();
      emitter.once('log', () => console.log('log once'));

      // Returns a new Array with a function `onceWrapper` which has a property
      // `listener` which contains the original listener bound above
      const listeners = emitter.rawListeners('log');
      const logFnWrapper = listeners[0];

      // Logs "log once" to the console and does not unbind the `once` event
      logFnWrapper.listener();

      // Logs "log once" to the console and removes the listener
      logFnWrapper();

      emitter.on('log', () => console.log('log persistently'));
      // Will return a new Array with a single function bound by `.on()` above
      const newListeners = emitter.rawListeners('log');

      // Logs "log persistently" twice
      newListeners[0]();
      emitter.emit('log');
+
      +

      Parameters

      • eventName: string | symbol

      Returns Function[]

      Since

      v9.4.0

      +

    removeAllListeners

    • Removes all listeners, or those of the specified eventName.

      +

      It is bad practice to remove listeners added elsewhere in the code, +particularly when the EventEmitter instance was created by some other +component or module (e.g. sockets or file streams).

      +

      Returns a reference to the EventEmitter, so that calls can be chained.

      +

      Parameters

      • Optional event: string | symbol

      Returns IWorkerNode<Worker, Data>

      Since

      v0.1.26

      +

    removeListener

    • Removes the specified listener from the listener array for the event namedeventName.

      +
      const callback = (stream) => {
        console.log('someone connected!');
      };
      server.on('connection', callback);
      // ...
      server.removeListener('connection', callback);
+
      +

      removeListener() will remove, at most, one instance of a listener from the +listener array. If any single listener has been added multiple times to the +listener array for the specified eventName, then removeListener() must be +called multiple times to remove each instance.

      +

      Once an event is emitted, all listeners attached to it at the +time of emitting are called in order. This implies that anyremoveListener() or removeAllListeners() calls after emitting and before the last listener finishes execution +will not remove them fromemit() in progress. Subsequent events behave as expected.

      +
      import { EventEmitter } from 'node:events';
      class MyEmitter extends EventEmitter {}
      const myEmitter = new MyEmitter();

      const callbackA = () => {
        console.log('A');
        myEmitter.removeListener('event', callbackB);
      };

      const callbackB = () => {
        console.log('B');
      };

      myEmitter.on('event', callbackA);

      myEmitter.on('event', callbackB);

      // callbackA removes listener callbackB but it will still be called.
      // Internal listener array at time of emit [callbackA, callbackB]
      myEmitter.emit('event');
      // Prints:
      //   A
      //   B

      // callbackB is now removed.
      // Internal listener array [callbackA]
      myEmitter.emit('event');
      // Prints:
      //   A
+
      +

      Because listeners are managed using an internal array, calling this will +change the position indices of any listener registered after the listener +being removed. This will not impact the order in which listeners are called, +but it means that any copies of the listener array as returned by +the emitter.listeners() method will need to be recreated.

      +

      When a single function has been added as a handler multiple times for a single +event (as in the example below), removeListener() will remove the most +recently added instance. In the example the once('ping')listener is removed:

      +
      import { EventEmitter } from 'node:events';
      const ee = new EventEmitter();

      function pong() {
        console.log('pong');
      }

      ee.on('ping', pong);
      ee.once('ping', pong);
      ee.removeListener('ping', pong);

      ee.emit('ping');
      ee.emit('ping');
+
      +

      Returns a reference to the EventEmitter, so that calls can be chained.

      +

      Parameters

      • eventName: string | symbol
      • listener: ((...args) => void)
          • (...args): void

          • Parameters

            • Rest ...args: any[]

            Returns void

      Returns IWorkerNode<Worker, Data>

      Since

      v0.1.26

      +

    setMaxListeners

    • By default EventEmitters will print a warning if more than 10 listeners are +added for a particular event. This is a useful default that helps finding +memory leaks. The emitter.setMaxListeners() method allows the limit to be +modified for this specific EventEmitter instance. The value can be set toInfinity (or 0) to indicate an unlimited number of listeners.

      +

      Returns a reference to the EventEmitter, so that calls can be chained.

      +

      Parameters

      • n: number

      Returns IWorkerNode<Worker, Data>

      Since

      v0.3.5

      +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/MeasurementOptions.html b/docs/interfaces/MeasurementOptions.html index 9c04675f..871e1e90 100644 --- a/docs/interfaces/MeasurementOptions.html +++ b/docs/interfaces/MeasurementOptions.html @@ -1,4 +1,4 @@ -MeasurementOptions | poolifier - v3.0.7

    Interface MeasurementOptions

    Measurement options.

    -

    Hierarchy

    • MeasurementOptions

    Properties

    median +MeasurementOptions | poolifier - v3.0.8

    Interface MeasurementOptions

    Measurement options.

    +

    Hierarchy

    • MeasurementOptions

    Properties

    median

    Properties

    Readonly median

    median: boolean

    Set measurement median.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/MeasurementStatistics.html b/docs/interfaces/MeasurementStatistics.html index 1dc75ce5..06972f10 100644 --- a/docs/interfaces/MeasurementStatistics.html +++ b/docs/interfaces/MeasurementStatistics.html @@ -1,14 +1,14 @@ -MeasurementStatistics | poolifier - v3.0.7

    Interface MeasurementStatisticsInternal

    Measurement statistics.

    -

    Hierarchy

    • MeasurementStatistics

    Properties

    aggregate? +MeasurementStatistics | poolifier - v3.0.8

    Interface MeasurementStatisticsInternal

    Measurement statistics.

    +

    Hierarchy

    • MeasurementStatistics

    Properties

    aggregate? average? history maximum? median? minimum?

    Properties

    Optional aggregate

    aggregate?: number

    Measurement aggregate.

    -

    Optional average

    average?: number

    Measurement average.

    -

    Readonly history

    history: CircularArray<number>

    Measurement history.

    -

    Optional maximum

    maximum?: number

    Measurement maximum.

    -

    Optional median

    median?: number

    Measurement median.

    -

    Optional minimum

    minimum?: number

    Measurement minimum.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Optional average

    average?: number

    Measurement average.

    +

    Readonly history

    history: CircularArray<number>

    Measurement history.

    +

    Optional maximum

    maximum?: number

    Measurement maximum.

    +

    Optional median

    median?: number

    Measurement median.

    +

    Optional minimum

    minimum?: number

    Measurement minimum.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/MeasurementStatisticsRequirements.html b/docs/interfaces/MeasurementStatisticsRequirements.html index 073bb9eb..94dca781 100644 --- a/docs/interfaces/MeasurementStatisticsRequirements.html +++ b/docs/interfaces/MeasurementStatisticsRequirements.html @@ -1,8 +1,8 @@ -MeasurementStatisticsRequirements | poolifier - v3.0.7

    Interface MeasurementStatisticsRequirementsInternal

    Measurement statistics requirements.

    -

    Hierarchy

    • MeasurementStatisticsRequirements

    Properties

    aggregate +MeasurementStatisticsRequirements | poolifier - v3.0.8

    Interface MeasurementStatisticsRequirementsInternal

    Measurement statistics requirements.

    +

    Hierarchy

    • MeasurementStatisticsRequirements

    Properties

    aggregate average median

    Properties

    aggregate

    aggregate: boolean

    Requires measurement aggregate.

    -

    average

    average: boolean

    Requires measurement average.

    -

    median

    median: boolean

    Requires measurement median.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    average

    average: boolean

    Requires measurement average.

    +

    median

    median: boolean

    Requires measurement median.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/MessageValue.html b/docs/interfaces/MessageValue.html index a47e35e3..a434b619 100644 --- a/docs/interfaces/MessageValue.html +++ b/docs/interfaces/MessageValue.html @@ -1,7 +1,7 @@ -MessageValue | poolifier - v3.0.7

    Interface MessageValue<Data, ErrorData>Internal

    Message object that is passed between main worker and worker.

    +MessageValue | poolifier - v3.0.8

    Interface MessageValue<Data, ErrorData>Internal

    Message object that is passed between main worker and worker.

    Type Parameters

    • Data = unknown

      Type of data sent to the worker or execution response. This can only be structured-cloneable data.

    • ErrorData = unknown

      Type of data sent to the worker triggering an error. This can only be structured-cloneable data.

      -

    Hierarchy

    • Task<Data>
      • MessageValue

    Properties

    checkActive? +

    Hierarchy

    • Task<Data>
      • MessageValue

    Properties

    checkActive? data? kill? name? @@ -20,26 +20,26 @@ workerError? workerId?

    Properties

    Optional Readonly checkActive

    checkActive?: boolean

    Whether the worker starts or stops its activity check.

    -

    Optional Readonly data

    data?: Data

    Task input data that will be passed to the worker.

    -

    Optional Readonly kill

    kill?: true | "success" | "SOFT" | "HARD" | "failure"

    Kill code.

    -

    Optional Readonly name

    name?: string

    Task name.

    -

    Optional Readonly port

    port?: MessagePort

    Message port.

    -

    Optional Readonly ready

    ready?: boolean

    Whether the worker is ready or not.

    -

    Optional Readonly statistics

    statistics?: WorkerStatistics

    Whether the worker computes the given statistics or not.

    -

    Optional Readonly taskFunction

    taskFunction?: string

    Task function serialized to string.

    -

    Optional Readonly taskFunctionName

    taskFunctionName?: string

    Task function name.

    -

    Optional Readonly taskFunctionNames

    taskFunctionNames?: string[]

    Task function names.

    -

    Optional Readonly taskFunctionOperation

    taskFunctionOperation?: "add" | "default" | "remove"

    Task function operation:

    +

    Optional Readonly data

    data?: Data

    Task input data that will be passed to the worker.

    +

    Optional Readonly kill

    kill?: true | "success" | "SOFT" | "HARD" | "failure"

    Kill code.

    +

    Optional Readonly name

    name?: string

    Task name.

    +

    Optional Readonly port

    port?: MessagePort

    Message port.

    +

    Optional Readonly ready

    ready?: boolean

    Whether the worker is ready or not.

    +

    Optional Readonly statistics

    statistics?: WorkerStatistics

    Whether the worker computes the given statistics or not.

    +

    Optional Readonly taskFunction

    taskFunction?: string

    Task function serialized to string.

    +

    Optional Readonly taskFunctionName

    taskFunctionName?: string

    Task function name.

    +

    Optional Readonly taskFunctionNames

    taskFunctionNames?: string[]

    Task function names.

    +

    Optional Readonly taskFunctionOperation

    taskFunctionOperation?: "add" | "default" | "remove"

    Task function operation:

    • 'add' - Add a task function.
    • 'remove' - Remove a task function.
    • 'default' - Set a task function as default.
    -

    Optional Readonly taskFunctionOperationStatus

    taskFunctionOperationStatus?: boolean

    Whether the task function operation is successful or not.

    -

    Optional Readonly taskId

    taskId?: string

    Task UUID.

    -

    Optional Readonly taskPerformance

    taskPerformance?: TaskPerformance

    Task performance.

    -

    Optional Readonly timestamp

    timestamp?: number

    Timestamp.

    -

    Optional Readonly transferList

    transferList?: TransferListItem[]

    Array of transferable objects.

    -

    Optional Readonly workerError

    workerError?: WorkerError<ErrorData>

    Worker error.

    -

    Optional Readonly workerId

    workerId?: number

    Worker id.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Optional Readonly taskFunctionOperationStatus

    taskFunctionOperationStatus?: boolean

    Whether the task function operation is successful or not.

    +

    Optional Readonly taskId

    taskId?: string

    Task UUID.

    +

    Optional Readonly taskPerformance

    taskPerformance?: TaskPerformance

    Task performance.

    +

    Optional Readonly timestamp

    timestamp?: number

    Timestamp.

    +

    Optional Readonly transferList

    transferList?: TransferListItem[]

    Array of transferable objects.

    +

    Optional Readonly workerError

    workerError?: WorkerError<ErrorData>

    Worker error.

    +

    Optional Readonly workerId

    workerId?: number

    Worker id.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/PoolInfo.html b/docs/interfaces/PoolInfo.html index 908b02a4..76ffafef 100644 --- a/docs/interfaces/PoolInfo.html +++ b/docs/interfaces/PoolInfo.html @@ -1,5 +1,5 @@ -PoolInfo | poolifier - v3.0.7

    Interface PoolInfo

    Pool information.

    -

    Hierarchy

    • PoolInfo

    Properties

    backPressure? +PoolInfo | poolifier - v3.0.8

    Interface PoolInfo

    Pool information.

    +

    Hierarchy

    • PoolInfo

    Properties

    backPressure? busyWorkerNodes executedTasks executingTasks @@ -20,8 +20,8 @@ waitTime? worker workerNodes -

    Properties

    Optional Readonly backPressure

    backPressure?: boolean

    Readonly busyWorkerNodes

    busyWorkerNodes: number

    Pool busy worker nodes.

    -

    Readonly executedTasks

    executedTasks: number

    Readonly executingTasks

    executingTasks: number

    Readonly failedTasks

    failedTasks: number

    Readonly idleWorkerNodes

    idleWorkerNodes: number

    Pool idle worker nodes.

    -

    Optional Readonly maxQueuedTasks

    maxQueuedTasks?: number

    Readonly maxSize

    maxSize: number

    Readonly minSize

    minSize: number

    Optional Readonly queuedTasks

    queuedTasks?: number

    Readonly ready

    ready: boolean

    Optional Readonly runTime

    runTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }

    Type declaration

    • Optional Readonly average?: number
    • Readonly maximum: number
    • Optional Readonly median?: number
    • Readonly minimum: number

    Readonly started

    started: boolean

    Optional Readonly stolenTasks

    stolenTasks?: number

    Readonly strategy

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

    Readonly type

    type: "fixed" | "dynamic"

    Optional Readonly utilization

    utilization?: number

    Pool utilization.

    -

    Readonly version

    version: string

    Optional Readonly waitTime

    waitTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }

    Type declaration

    • Optional Readonly average?: number
    • Readonly maximum: number
    • Optional Readonly median?: number
    • Readonly minimum: number

    Readonly worker

    worker: "thread" | "cluster"

    Readonly workerNodes

    workerNodes: number

    Pool total worker nodes.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    Optional Readonly backPressure

    backPressure?: boolean

    Readonly busyWorkerNodes

    busyWorkerNodes: number

    Pool busy worker nodes.

    +

    Readonly executedTasks

    executedTasks: number

    Readonly executingTasks

    executingTasks: number

    Readonly failedTasks

    failedTasks: number

    Readonly idleWorkerNodes

    idleWorkerNodes: number

    Pool idle worker nodes.

    +

    Optional Readonly maxQueuedTasks

    maxQueuedTasks?: number

    Readonly maxSize

    maxSize: number

    Readonly minSize

    minSize: number

    Optional Readonly queuedTasks

    queuedTasks?: number

    Readonly ready

    ready: boolean

    Optional Readonly runTime

    runTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }

    Type declaration

    • Optional Readonly average?: number
    • Readonly maximum: number
    • Optional Readonly median?: number
    • Readonly minimum: number

    Readonly started

    started: boolean

    Optional Readonly stolenTasks

    stolenTasks?: number

    Readonly strategy

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

    Readonly type

    type: "fixed" | "dynamic"

    Optional Readonly utilization

    utilization?: number

    Pool utilization.

    +

    Readonly version

    version: string

    Optional Readonly waitTime

    waitTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }

    Type declaration

    • Optional Readonly average?: number
    • Readonly maximum: number
    • Optional Readonly median?: number
    • Readonly minimum: number

    Readonly worker

    worker: "thread" | "cluster"

    Readonly workerNodes

    workerNodes: number

    Pool total worker nodes.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/PoolOptions.html b/docs/interfaces/PoolOptions.html index de8d22b0..19d42713 100644 --- a/docs/interfaces/PoolOptions.html +++ b/docs/interfaces/PoolOptions.html @@ -1,6 +1,6 @@ -PoolOptions | poolifier - v3.0.7

    Interface PoolOptions<Worker>

    Options for a poolifier pool.

    +PoolOptions | poolifier - v3.0.8

    Interface PoolOptions<Worker>

    Options for a poolifier pool.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -

    Hierarchy

    Properties

    enableEvents? +

    Hierarchy

    Properties

    enableEvents? enableTasksQueue? errorHandler? exitHandler? @@ -14,24 +14,24 @@

    Properties

    Optional enableEvents

    enableEvents?: boolean

    Pool events integrated with async resource emission.

    Default Value

    true
    -

    Optional enableTasksQueue

    enableTasksQueue?: boolean

    Pool worker node tasks queue.

    +

    Optional enableTasksQueue

    enableTasksQueue?: boolean

    Pool worker node tasks queue.

    Default Value

    false
    -

    Optional errorHandler

    errorHandler?: ErrorHandler<Worker>

    A function that will listen for error event on each worker.

    +

    Optional errorHandler

    errorHandler?: ErrorHandler<Worker>

    A function that will listen for error event on each worker.

    Default Value

    () => {}

    -

    Optional exitHandler

    exitHandler?: ExitHandler<Worker>

    A function that will listen for exit event on each worker.

    +

    Optional exitHandler

    exitHandler?: ExitHandler<Worker>

    A function that will listen for exit event on each worker.

    Default Value

    () => {}

    -

    Optional messageHandler

    messageHandler?: MessageHandler<Worker>

    A function that will listen for message event on each worker.

    +

    Optional messageHandler

    messageHandler?: MessageHandler<Worker>

    A function that will listen for message event on each worker.

    Default Value

    () => {}

    -

    Optional onlineHandler

    onlineHandler?: OnlineHandler<Worker>

    A function that will listen for online event on each worker.

    +

    Optional onlineHandler

    onlineHandler?: OnlineHandler<Worker>

    A function that will listen for online event on each worker.

    Default Value

    () => {}

    -

    Optional restartWorkerOnError

    restartWorkerOnError?: boolean

    Restart worker on error.

    -

    Optional startWorkers

    startWorkers?: boolean

    Whether to start the minimum number of workers at pool initialization.

    +

    Optional restartWorkerOnError

    restartWorkerOnError?: boolean

    Restart worker on error.

    +

    Optional startWorkers

    startWorkers?: boolean

    Whether to start the minimum number of workers at pool initialization.

    Default Value

    true
    -

    Optional tasksQueueOptions

    tasksQueueOptions?: TasksQueueOptions

    Pool worker node tasks queue options.

    -

    Optional workerChoiceStrategy

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

    The worker choice strategy to use in this pool.

    +

    Optional tasksQueueOptions

    tasksQueueOptions?: TasksQueueOptions

    Pool worker node tasks queue options.

    +

    Optional workerChoiceStrategy

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

    The worker choice strategy to use in this pool.

    Default Value

    WorkerChoiceStrategies.ROUND_ROBIN
    -

    Optional workerChoiceStrategyOptions

    workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Optional workerChoiceStrategyOptions

    workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/PromiseResponseWrapper.html b/docs/interfaces/PromiseResponseWrapper.html index b88ecb80..3f5ed16b 100644 --- a/docs/interfaces/PromiseResponseWrapper.html +++ b/docs/interfaces/PromiseResponseWrapper.html @@ -1,9 +1,9 @@ -PromiseResponseWrapper | poolifier - v3.0.7

    Interface PromiseResponseWrapper<Response>Internal

    An object holding the task execution response promise resolve/reject callbacks.

    +PromiseResponseWrapper | poolifier - v3.0.8

    Interface PromiseResponseWrapper<Response>Internal

    An object holding the task execution response promise resolve/reject callbacks.

    Type Parameters

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy

    • PromiseResponseWrapper

    Properties

    reject +

    Hierarchy

    • PromiseResponseWrapper

    Properties

    reject resolve workerNodeKey

    Properties

    Readonly reject

    reject: ((reason?) => void)

    Type declaration

      • (reason?): void

      • Reject callback to reject the promise.

        -

        Parameters

        • Optional reason: unknown

        Returns void

    Readonly resolve

    resolve: ((value) => void)

    Type declaration

      • (value): void

      • Resolve callback to fulfill the promise.

        -

        Parameters

        • value: Response | PromiseLike<Response>

        Returns void

    Readonly workerNodeKey

    workerNodeKey: number

    The worker node key executing the task.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Parameters

    • Optional reason: unknown

    Returns void

    Readonly resolve

    resolve: ((value) => void)

    Type declaration

      • (value): void

      • Resolve callback to fulfill the promise.

        +

        Parameters

        • value: Response | PromiseLike<Response>

        Returns void

    Readonly workerNodeKey

    workerNodeKey: number

    The worker node key executing the task.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/StrategyData.html b/docs/interfaces/StrategyData.html index 146ed164..3b600548 100644 --- a/docs/interfaces/StrategyData.html +++ b/docs/interfaces/StrategyData.html @@ -1,3 +1,3 @@ -StrategyData | poolifier - v3.0.7

    Interface StrategyDataInternal

    Worker choice strategy data.

    -

    Hierarchy

    • StrategyData

    Properties

    virtualTaskEndTimestamp? -

    Properties

    Optional virtualTaskEndTimestamp

    virtualTaskEndTimestamp?: number

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +StrategyData | poolifier - v3.0.8

    Interface StrategyDataInternal

    Worker choice strategy data.

    +

    Hierarchy

    • StrategyData

    Properties

    virtualTaskEndTimestamp? +

    Properties

    Optional virtualTaskEndTimestamp

    virtualTaskEndTimestamp?: number

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/StrategyPolicy.html b/docs/interfaces/StrategyPolicy.html index 679172a3..d8fe2127 100644 --- a/docs/interfaces/StrategyPolicy.html +++ b/docs/interfaces/StrategyPolicy.html @@ -1,6 +1,6 @@ -StrategyPolicy | poolifier - v3.0.7

    Interface StrategyPolicyInternal

    Strategy policy.

    -

    Hierarchy

    • StrategyPolicy

    Properties

    dynamicWorkerReady +StrategyPolicy | poolifier - v3.0.8

    Interface StrategyPolicyInternal

    Strategy policy.

    +

    Hierarchy

    • StrategyPolicy

    Properties

    dynamicWorkerReady dynamicWorkerUsage

    Properties

    Readonly dynamicWorkerReady

    dynamicWorkerReady: boolean

    Expects the newly created dynamic worker to be flagged as ready.

    -

    Readonly dynamicWorkerUsage

    dynamicWorkerUsage: boolean

    Expects tasks execution on the newly created dynamic worker.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Readonly dynamicWorkerUsage

    dynamicWorkerUsage: boolean

    Expects tasks execution on the newly created dynamic worker.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/Task.html b/docs/interfaces/Task.html index 40d9ac94..ed771c4d 100644 --- a/docs/interfaces/Task.html +++ b/docs/interfaces/Task.html @@ -1,13 +1,13 @@ -Task | poolifier - v3.0.7

    Interface Task<Data>Internal

    Message object that is passed as a task between main worker and worker.

    +Task | poolifier - v3.0.8

    Interface Task<Data>Internal

    Message object that is passed as a task between main worker and worker.

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

      -

    Hierarchy

    Properties

    data? +

    Hierarchy

    Properties

    data? name? taskId? timestamp? transferList?

    Properties

    Optional Readonly data

    data?: Data

    Task input data that will be passed to the worker.

    -

    Optional Readonly name

    name?: string

    Task name.

    -

    Optional Readonly taskId

    taskId?: string

    Task UUID.

    -

    Optional Readonly timestamp

    timestamp?: number

    Timestamp.

    -

    Optional Readonly transferList

    transferList?: TransferListItem[]

    Array of transferable objects.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Optional Readonly name

    name?: string

    Task name.

    +

    Optional Readonly taskId

    taskId?: string

    Task UUID.

    +

    Optional Readonly timestamp

    timestamp?: number

    Timestamp.

    +

    Optional Readonly transferList

    transferList?: TransferListItem[]

    Array of transferable objects.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/TaskFunctionOperationResult.html b/docs/interfaces/TaskFunctionOperationResult.html index 62b204d5..41f71d28 100644 --- a/docs/interfaces/TaskFunctionOperationResult.html +++ b/docs/interfaces/TaskFunctionOperationResult.html @@ -1,4 +1,4 @@ -TaskFunctionOperationResult | poolifier - v3.0.7

    Interface TaskFunctionOperationResult

    Task function operation result.

    -

    Hierarchy

    • TaskFunctionOperationResult

    Properties

    error? +TaskFunctionOperationResult | poolifier - v3.0.8

    Interface TaskFunctionOperationResult

    Task function operation result.

    +

    Hierarchy

    • TaskFunctionOperationResult

    Properties

    error? status -

    Properties

    Optional error

    error?: Error

    status

    status: boolean

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    Optional error

    error?: Error

    status

    status: boolean

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/TaskPerformance.html b/docs/interfaces/TaskPerformance.html index 3d69e7f9..e82e6529 100644 --- a/docs/interfaces/TaskPerformance.html +++ b/docs/interfaces/TaskPerformance.html @@ -1,10 +1,10 @@ -TaskPerformance | poolifier - v3.0.7

    Interface TaskPerformanceInternal

    Task performance.

    -

    Hierarchy

    • TaskPerformance

    Properties

    elu? +TaskPerformance | poolifier - v3.0.8

    Interface TaskPerformanceInternal

    Task performance.

    +

    Hierarchy

    • TaskPerformance

    Properties

    elu? name runTime? timestamp

    Properties

    Optional Readonly elu

    elu?: EventLoopUtilization

    Task event loop utilization.

    -

    Readonly name

    name: string

    Task name.

    -

    Optional Readonly runTime

    runTime?: number

    Task runtime.

    -

    Readonly timestamp

    timestamp: number

    Task performance timestamp.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Readonly name

    name: string

    Task name.

    +

    Optional Readonly runTime

    runTime?: number

    Task runtime.

    +

    Readonly timestamp

    timestamp: number

    Task performance timestamp.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/TaskStatistics.html b/docs/interfaces/TaskStatistics.html index 134934ff..5ea27c82 100644 --- a/docs/interfaces/TaskStatistics.html +++ b/docs/interfaces/TaskStatistics.html @@ -1,14 +1,16 @@ -TaskStatistics | poolifier - v3.0.7

    Interface TaskStatisticsInternal

    Task statistics.

    -

    Hierarchy

    • TaskStatistics

    Properties

    executed +TaskStatistics | poolifier - v3.0.8

    Interface TaskStatisticsInternal

    Task statistics.

    +

    Hierarchy

    • TaskStatistics

    Properties

    executed executing failed maxQueued? queued +sequentiallyStolen stolen

    Properties

    executed

    executed: number

    Number of executed tasks.

    -

    executing

    executing: number

    Number of executing tasks.

    -

    failed

    failed: number

    Number of failed tasks.

    -

    Optional Readonly maxQueued

    maxQueued?: number

    Maximum number of queued tasks.

    -

    Readonly queued

    queued: number

    Number of queued tasks.

    -

    stolen

    stolen: number

    Number of stolen tasks.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    executing

    executing: number

    Number of executing tasks.

    +

    failed

    failed: number

    Number of failed tasks.

    +

    Optional Readonly maxQueued

    maxQueued?: number

    Maximum number of queued tasks.

    +

    Readonly queued

    queued: number

    Number of queued tasks.

    +

    sequentiallyStolen

    sequentiallyStolen: number

    Number of sequentially stolen tasks.

    +

    stolen

    stolen: number

    Number of stolen tasks.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/TaskStatisticsRequirements.html b/docs/interfaces/TaskStatisticsRequirements.html index e06cbb86..6f0d2cee 100644 --- a/docs/interfaces/TaskStatisticsRequirements.html +++ b/docs/interfaces/TaskStatisticsRequirements.html @@ -1,8 +1,8 @@ -TaskStatisticsRequirements | poolifier - v3.0.7

    Interface TaskStatisticsRequirementsInternal

    Pool worker node worker usage statistics requirements.

    -

    Hierarchy

    • TaskStatisticsRequirements

    Properties

    elu +TaskStatisticsRequirements | poolifier - v3.0.8

    Interface TaskStatisticsRequirementsInternal

    Pool worker node worker usage statistics requirements.

    +

    Hierarchy

    • TaskStatisticsRequirements

    Properties

    elu runTime waitTime

    Properties

    Readonly elu

    elu: MeasurementStatisticsRequirements

    Tasks event loop utilization requirements.

    -

    Readonly runTime

    runTime: MeasurementStatisticsRequirements

    Tasks runtime requirements.

    -

    Readonly waitTime

    waitTime: MeasurementStatisticsRequirements

    Tasks wait time requirements.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Readonly runTime

    runTime: MeasurementStatisticsRequirements

    Tasks runtime requirements.

    +

    Readonly waitTime

    waitTime: MeasurementStatisticsRequirements

    Tasks wait time requirements.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/TasksQueueOptions.html b/docs/interfaces/TasksQueueOptions.html index b61bce5b..f58bf173 100644 --- a/docs/interfaces/TasksQueueOptions.html +++ b/docs/interfaces/TasksQueueOptions.html @@ -1,18 +1,18 @@ -TasksQueueOptions | poolifier - v3.0.7

    Interface TasksQueueOptions

    Worker node tasks queue options.

    -

    Hierarchy

    • TasksQueueOptions

    Properties

    concurrency? +TasksQueueOptions | poolifier - v3.0.8

    Interface TasksQueueOptions

    Worker node tasks queue options.

    +

    Hierarchy

    • TasksQueueOptions

    Properties

    concurrency? size? taskStealing? tasksStealingOnBackPressure?

    Properties

    Optional Readonly concurrency

    concurrency?: number

    Maximum number of tasks that can be executed concurrently on a worker node.

    Default Value

    1
    -

    Optional Readonly size

    size?: number

    Maximum tasks queue size per worker node flagging it as back pressured.

    +

    Optional Readonly size

    size?: number

    Maximum tasks queue size per worker node flagging it as back pressured.

    Default Value

    (pool maximum size)^2
    -

    Optional Readonly taskStealing

    taskStealing?: boolean

    Whether to enable task stealing on idle.

    +

    Optional Readonly taskStealing

    taskStealing?: boolean

    Whether to enable task stealing on idle.

    Default Value

    true
    -

    Optional Readonly tasksStealingOnBackPressure

    tasksStealingOnBackPressure?: boolean

    Whether to enable tasks stealing under back pressure.

    +

    Optional Readonly tasksStealingOnBackPressure

    tasksStealingOnBackPressure?: boolean

    Whether to enable tasks stealing under back pressure.

    Default Value

    true
    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/ThreadPoolOptions.html b/docs/interfaces/ThreadPoolOptions.html index 601e0d71..15694571 100644 --- a/docs/interfaces/ThreadPoolOptions.html +++ b/docs/interfaces/ThreadPoolOptions.html @@ -1,5 +1,5 @@ -ThreadPoolOptions | poolifier - v3.0.7

    Interface ThreadPoolOptions

    Options for a poolifier thread pool.

    -

    Hierarchy

    Properties

    enableEvents? +ThreadPoolOptions | poolifier - v3.0.8

    Interface ThreadPoolOptions

    Options for a poolifier thread pool.

    +

    Hierarchy

    Properties

    enableEvents? enableTasksQueue? errorHandler? exitHandler? @@ -14,26 +14,26 @@

    Properties

    Optional enableEvents

    enableEvents?: boolean

    Pool events integrated with async resource emission.

    Default Value

    true
    -

    Optional enableTasksQueue

    enableTasksQueue?: boolean

    Pool worker node tasks queue.

    +

    Optional enableTasksQueue

    enableTasksQueue?: boolean

    Pool worker node tasks queue.

    Default Value

    false
    -

    Optional errorHandler

    errorHandler?: ErrorHandler<Worker>

    A function that will listen for error event on each worker.

    +

    Optional errorHandler

    errorHandler?: ErrorHandler<Worker>

    A function that will listen for error event on each worker.

    Default Value

    () => {}

    -

    Optional exitHandler

    exitHandler?: ExitHandler<Worker>

    A function that will listen for exit event on each worker.

    +

    Optional exitHandler

    exitHandler?: ExitHandler<Worker>

    A function that will listen for exit event on each worker.

    Default Value

    () => {}

    -

    Optional messageHandler

    messageHandler?: MessageHandler<Worker>

    A function that will listen for message event on each worker.

    +

    Optional messageHandler

    messageHandler?: MessageHandler<Worker>

    A function that will listen for message event on each worker.

    Default Value

    () => {}

    -

    Optional onlineHandler

    onlineHandler?: OnlineHandler<Worker>

    A function that will listen for online event on each worker.

    +

    Optional onlineHandler

    onlineHandler?: OnlineHandler<Worker>

    A function that will listen for online event on each worker.

    Default Value

    () => {}

    -

    Optional restartWorkerOnError

    restartWorkerOnError?: boolean

    Restart worker on error.

    -

    Optional startWorkers

    startWorkers?: boolean

    Whether to start the minimum number of workers at pool initialization.

    +

    Optional restartWorkerOnError

    restartWorkerOnError?: boolean

    Restart worker on error.

    +

    Optional startWorkers

    startWorkers?: boolean

    Whether to start the minimum number of workers at pool initialization.

    Default Value

    true
    -

    Optional tasksQueueOptions

    tasksQueueOptions?: TasksQueueOptions

    Pool worker node tasks queue options.

    -

    Optional workerChoiceStrategy

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

    The worker choice strategy to use in this pool.

    +

    Optional tasksQueueOptions

    tasksQueueOptions?: TasksQueueOptions

    Pool worker node tasks queue options.

    +

    Optional workerChoiceStrategy

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

    The worker choice strategy to use in this pool.

    Default Value

    WorkerChoiceStrategies.ROUND_ROBIN
    -

    Optional workerChoiceStrategyOptions

    workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    -

    Optional workerOptions

    workerOptions?: WorkerOptions

    Worker options.

    +

    Optional workerChoiceStrategyOptions

    workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    +

    Optional workerOptions

    workerOptions?: WorkerOptions

    Worker options.

    See

    https://nodejs.org/api/worker_threads.html#new-workerfilename-options

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/WorkerChoiceStrategyOptions.html b/docs/interfaces/WorkerChoiceStrategyOptions.html index 69ea4573..9a44e279 100644 --- a/docs/interfaces/WorkerChoiceStrategyOptions.html +++ b/docs/interfaces/WorkerChoiceStrategyOptions.html @@ -1,25 +1,25 @@ -WorkerChoiceStrategyOptions | poolifier - v3.0.7

    Interface WorkerChoiceStrategyOptions

    Worker choice strategy options.

    -

    Hierarchy

    • WorkerChoiceStrategyOptions

    Properties

    elu? +WorkerChoiceStrategyOptions | poolifier - v3.0.8

    Interface WorkerChoiceStrategyOptions

    Worker choice strategy options.

    +

    Hierarchy

    • WorkerChoiceStrategyOptions

    Properties

    elu? measurement? retries? runTime? waitTime? weights?

    Properties

    Optional Readonly elu

    elu?: MeasurementOptions

    Event loop utilization options.

    -

    Default Value

    { median: false }
+

    Default Value

    { median: false }
    -

    Optional Readonly measurement

    measurement?: "runTime" | "waitTime" | "elu"

    Measurement to use in worker choice strategy supporting it.

    -

    Optional Readonly retries

    retries?: number

    Number of worker choice retries to perform if no worker is eligible.

    +

    Optional Readonly measurement

    measurement?: "runTime" | "waitTime" | "elu"

    Measurement to use in worker choice strategy supporting it.

    +

    Optional Readonly retries

    retries?: number

    Number of worker choice retries to perform if no worker is eligible.

    Default Value

    6
    -

    Optional Readonly runTime

    runTime?: MeasurementOptions

    Runtime options.

    -

    Default Value

    { median: false }
+

    Optional Readonly runTime

    runTime?: MeasurementOptions

    Runtime options.

    +

    Default Value

    { median: false }
    -

    Optional Readonly waitTime

    waitTime?: MeasurementOptions

    Wait time options.

    -

    Default Value

    { median: false }
+

    Optional Readonly waitTime

    waitTime?: MeasurementOptions

    Wait time options.

    +

    Default Value

    { median: false }
    -

    Optional Readonly weights

    weights?: Record<number, number>

    Worker weights to use for weighted round robin worker selection strategies. +

    Optional Readonly weights

    weights?: Record<number, number>

    Worker weights to use for weighted round robin worker selection strategies. A weight is tasks maximum execution time in milliseconds for a worker node.

    Default Value

    Weights computed automatically given the CPU performance.
    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/WorkerError.html b/docs/interfaces/WorkerError.html index e4e23797..45576c9f 100644 --- a/docs/interfaces/WorkerError.html +++ b/docs/interfaces/WorkerError.html @@ -1,9 +1,9 @@ -WorkerError | poolifier - v3.0.7

    Interface WorkerError<Data>

    Worker error.

    +WorkerError | poolifier - v3.0.8

    Interface WorkerError<Data>

    Worker error.

    Type Parameters

    • Data = unknown

      Type of data sent to the worker triggering an error. This can only be structured-cloneable data.

      -

    Hierarchy

    • WorkerError

    Properties

    data? +

    Hierarchy

    • WorkerError

    Properties

    data? message name

    Properties

    Optional Readonly data

    data?: Data

    Data triggering the error.

    -

    Readonly message

    message: string

    Error message.

    -

    Readonly name

    name: string

    Task function name triggering the error.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Readonly message

    message: string

    Error message.

    +

    Readonly name

    name: string

    Task function name triggering the error.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/WorkerInfo.html b/docs/interfaces/WorkerInfo.html index 5fe2a24e..62a2571a 100644 --- a/docs/interfaces/WorkerInfo.html +++ b/docs/interfaces/WorkerInfo.html @@ -1,12 +1,12 @@ -WorkerInfo | poolifier - v3.0.7

    Interface WorkerInfoInternal

    Worker information.

    -

    Hierarchy

    • WorkerInfo

    Properties

    dynamic +WorkerInfo | poolifier - v3.0.8

    Interface WorkerInfoInternal

    Worker information.

    +

    Hierarchy

    • WorkerInfo

    Properties

    dynamic id ready taskFunctionNames? type

    Properties

    dynamic

    dynamic: boolean

    Dynamic flag.

    -

    Readonly id

    id: undefined | number

    Worker id.

    -

    ready

    ready: boolean

    Ready flag.

    -

    Optional taskFunctionNames

    taskFunctionNames?: string[]

    Task function names.

    -

    Readonly type

    type: "thread" | "cluster"

    Worker type.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Readonly id

    id: undefined | number

    Worker id.

    +

    ready

    ready: boolean

    Ready flag.

    +

    Optional taskFunctionNames

    taskFunctionNames?: string[]

    Task function names.

    +

    Readonly type

    type: "thread" | "cluster"

    Worker type.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/WorkerNodeEventDetail.html b/docs/interfaces/WorkerNodeEventDetail.html index f6f29c25..23b5e86a 100644 --- a/docs/interfaces/WorkerNodeEventDetail.html +++ b/docs/interfaces/WorkerNodeEventDetail.html @@ -1,3 +1,4 @@ -WorkerNodeEventDetail | poolifier - v3.0.7

    Interface WorkerNodeEventDetailInternal

    Worker node event detail.

    -

    Hierarchy

    • WorkerNodeEventDetail

    Properties

    workerId -

    Properties

    workerId

    workerId: number

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +WorkerNodeEventDetail | poolifier - v3.0.8

    Interface WorkerNodeEventDetailInternal

    Worker node event detail.

    +

    Hierarchy

    • WorkerNodeEventDetail

    Properties

    workerId +workerNodeKey? +

    Properties

    workerId

    workerId: number

    Optional workerNodeKey

    workerNodeKey?: number

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/WorkerOptions.html b/docs/interfaces/WorkerOptions.html index 2a4e4517..d5f51893 100644 --- a/docs/interfaces/WorkerOptions.html +++ b/docs/interfaces/WorkerOptions.html @@ -1,5 +1,5 @@ -WorkerOptions | poolifier - v3.0.7

    Interface WorkerOptions

    Options for workers.

    -

    Hierarchy

    • WorkerOptions

    Properties

    killBehavior? +WorkerOptions | poolifier - v3.0.8

    Interface WorkerOptions

    Options for workers.

    +

    Hierarchy

    • WorkerOptions

    Properties

    killBehavior? killHandler? maxInactiveTime?

    Properties

    Optional killBehavior

    killBehavior?: "SOFT" | "HARD"

    killBehavior dictates if your worker will be deleted in case a task is active on it.

    @@ -10,9 +10,9 @@

    This option only apply to the newly created workers.

    Default Value

    KillBehaviors.SOFT
    -

    Optional killHandler

    killHandler?: KillHandler

    The function to call when a worker is killed.

    +

    Optional killHandler

    killHandler?: KillHandler

    The function to call when a worker is killed.

    Default Value

    () => {}

    -

    Optional maxInactiveTime

    maxInactiveTime?: number

    Maximum waiting time in milliseconds for tasks on newly created workers. It must be greater or equal than 5.

    +

    Optional maxInactiveTime

    maxInactiveTime?: number

    Maximum waiting time in milliseconds for tasks on newly created workers. It must be greater or equal than 5.

    After this time, newly created workers will be terminated. The last active time of your worker will be updated when it terminates a task.

      @@ -22,4 +22,4 @@ when this timeout expires your tasks is interrupted before completion and remove

    Default Value

    60000
    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/WorkerStatistics.html b/docs/interfaces/WorkerStatistics.html index 726243f2..00e60b47 100644 --- a/docs/interfaces/WorkerStatistics.html +++ b/docs/interfaces/WorkerStatistics.html @@ -1,6 +1,6 @@ -WorkerStatistics | poolifier - v3.0.7

    Interface WorkerStatisticsInternal

    Worker task performance statistics computation settings.

    -

    Hierarchy

    • WorkerStatistics

    Properties

    elu +WorkerStatistics | poolifier - v3.0.8

    Interface WorkerStatisticsInternal

    Worker task performance statistics computation settings.

    +

    Hierarchy

    • WorkerStatistics

    Properties

    elu runTime

    Properties

    Readonly elu

    elu: boolean

    Whether the worker computes the task event loop utilization (ELU) or not.

    -

    Readonly runTime

    runTime: boolean

    Whether the worker computes the task runtime or not.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Readonly runTime

    runTime: boolean

    Whether the worker computes the task runtime or not.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/interfaces/WorkerUsage.html b/docs/interfaces/WorkerUsage.html index e7644771..3a9a8c5b 100644 --- a/docs/interfaces/WorkerUsage.html +++ b/docs/interfaces/WorkerUsage.html @@ -1,10 +1,10 @@ -WorkerUsage | poolifier - v3.0.7

    Interface WorkerUsageInternal

    Worker usage statistics.

    -

    Hierarchy

    • WorkerUsage

    Properties

    elu +WorkerUsage | poolifier - v3.0.8

    Interface WorkerUsageInternal

    Worker usage statistics.

    +

    Hierarchy

    • WorkerUsage

    Properties

    elu runTime tasks waitTime

    Properties

    Readonly elu

    elu: EventLoopUtilizationMeasurementStatistics

    Tasks event loop utilization statistics.

    -

    Readonly runTime

    runTime: MeasurementStatistics

    Tasks runtime statistics.

    -

    Readonly tasks

    tasks: TaskStatistics

    Tasks statistics.

    -

    Readonly waitTime

    waitTime: MeasurementStatistics

    Tasks wait time statistics.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file +

    Readonly runTime

    runTime: MeasurementStatistics

    Tasks runtime statistics.

    +

    Readonly tasks

    tasks: TaskStatistics

    Tasks statistics.

    +

    Readonly waitTime

    waitTime: MeasurementStatistics

    Tasks wait time statistics.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/ErrorHandler.html b/docs/types/ErrorHandler.html index 14b4a1dc..4e2aacf9 100644 --- a/docs/types/ErrorHandler.html +++ b/docs/types/ErrorHandler.html @@ -1,3 +1,3 @@ -ErrorHandler | poolifier - v3.0.7

    Type alias ErrorHandler<Worker>

    ErrorHandler<Worker>: ((this, error) => void)

    Type Parameters

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/ExitHandler.html b/docs/types/ExitHandler.html index d418ebf9..d9ae9357 100644 --- a/docs/types/ExitHandler.html +++ b/docs/types/ExitHandler.html @@ -1,3 +1,3 @@ -ExitHandler | poolifier - v3.0.7

    Type alias ExitHandler<Worker>

    ExitHandler<Worker>: ((this, exitCode) => void)

    Type Parameters

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/KillBehavior.html b/docs/types/KillBehavior.html index 32c9cbd5..a21ada62 100644 --- a/docs/types/KillBehavior.html +++ b/docs/types/KillBehavior.html @@ -1,2 +1,2 @@ -KillBehavior | poolifier - v3.0.7

    Type alias KillBehavior

    KillBehavior: keyof typeof KillBehaviors

    Kill behavior.

    -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +KillBehavior | poolifier - v3.0.8

    Type alias KillBehavior

    KillBehavior: keyof typeof KillBehaviors

    Kill behavior.

    +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/KillHandler.html b/docs/types/KillHandler.html index 151009c5..4b2019bf 100644 --- a/docs/types/KillHandler.html +++ b/docs/types/KillHandler.html @@ -1,2 +1,2 @@ -KillHandler | poolifier - v3.0.7

    Type alias KillHandler

    KillHandler: (() => void | Promise<void>)

    Type declaration

      • (): void | Promise<void>

      • Handler called when a worker is killed.

        -

        Returns void | Promise<void>

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +KillHandler | poolifier - v3.0.8

    Type alias KillHandler

    KillHandler: (() => void | Promise<void>)

    Type declaration

      • (): void | Promise<void>

      • Handler called when a worker is killed.

        +

        Returns void | Promise<void>

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/Measurement.html b/docs/types/Measurement.html index a28dd615..36599f84 100644 --- a/docs/types/Measurement.html +++ b/docs/types/Measurement.html @@ -1,2 +1,2 @@ -Measurement | poolifier - v3.0.7

    Type alias Measurement

    Measurement: keyof typeof Measurements

    Measurement.

    -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +Measurement | poolifier - v3.0.8

    Type alias Measurement

    Measurement: keyof typeof Measurements

    Measurement.

    +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/MessageHandler.html b/docs/types/MessageHandler.html index 4e525b5d..1ebd0468 100644 --- a/docs/types/MessageHandler.html +++ b/docs/types/MessageHandler.html @@ -1,3 +1,3 @@ -MessageHandler | poolifier - v3.0.7

    Type alias MessageHandler<Worker>

    MessageHandler<Worker>: ((this, message) => void)

    Type Parameters

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/OnlineHandler.html b/docs/types/OnlineHandler.html index 65f697d6..03e5bb47 100644 --- a/docs/types/OnlineHandler.html +++ b/docs/types/OnlineHandler.html @@ -1,3 +1,3 @@ -OnlineHandler | poolifier - v3.0.7

    Type alias OnlineHandler<Worker>

    OnlineHandler<Worker>: ((this) => void)

    Type Parameters

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/PoolEvent.html b/docs/types/PoolEvent.html index b18d5526..4fe869c3 100644 --- a/docs/types/PoolEvent.html +++ b/docs/types/PoolEvent.html @@ -1,2 +1,2 @@ -PoolEvent | poolifier - v3.0.7

    Type alias PoolEvent

    PoolEvent: keyof typeof PoolEvents

    Pool event.

    -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +PoolEvent | poolifier - v3.0.8

    Type alias PoolEvent

    PoolEvent: keyof typeof PoolEvents

    Pool event.

    +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/PoolType.html b/docs/types/PoolType.html index 8a37220a..d255d0ca 100644 --- a/docs/types/PoolType.html +++ b/docs/types/PoolType.html @@ -1,2 +1,2 @@ -PoolType | poolifier - v3.0.7

    Type alias PoolType

    PoolType: keyof typeof PoolTypes

    Pool type.

    -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +PoolType | poolifier - v3.0.8

    Type alias PoolType

    PoolType: keyof typeof PoolTypes

    Pool type.

    +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/TaskAsyncFunction.html b/docs/types/TaskAsyncFunction.html index 8fb84339..ed7681d7 100644 --- a/docs/types/TaskAsyncFunction.html +++ b/docs/types/TaskAsyncFunction.html @@ -1,6 +1,6 @@ -TaskAsyncFunction | poolifier - v3.0.7

    Type alias TaskAsyncFunction<Data, Response>

    TaskAsyncFunction<Data, Response>: ((data?) => Promise<Response>)

    Type Parameters

    Returns Promise<Response>

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/TaskFunction.html b/docs/types/TaskFunction.html index aed11fd4..b7b8b8cb 100644 --- a/docs/types/TaskFunction.html +++ b/docs/types/TaskFunction.html @@ -1,5 +1,5 @@ -TaskFunction | poolifier - v3.0.7

    Type alias TaskFunction<Data, Response>

    TaskFunction<Data, Response>: TaskSyncFunction<Data, Response> | TaskAsyncFunction<Data, Response>

    Task function that can be executed. +TaskFunction | poolifier - v3.0.8

    Type alias TaskFunction<Data, Response>

    TaskFunction<Data, Response>: TaskSyncFunction<Data, Response> | TaskAsyncFunction<Data, Response>

    Task function that can be executed. This function can be synchronous or asynchronous.

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/TaskFunctions.html b/docs/types/TaskFunctions.html index 11f466b5..bb8f5f9a 100644 --- a/docs/types/TaskFunctions.html +++ b/docs/types/TaskFunctions.html @@ -1,7 +1,7 @@ -TaskFunctions | poolifier - v3.0.7

    Type alias TaskFunctions<Data, Response>

    TaskFunctions<Data, Response>: Record<string, TaskFunction<Data, Response>>

    Tasks functions that can be executed. +TaskFunctions | poolifier - v3.0.8

    Type alias TaskFunctions<Data, Response>

    TaskFunctions<Data, Response>: Record<string, TaskFunction<Data, Response>>

    Tasks functions that can be executed. This object can contain synchronous or asynchronous functions. The key is the name of the function. The value is the function itself.

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/TaskSyncFunction.html b/docs/types/TaskSyncFunction.html index 6e373911..d21cd493 100644 --- a/docs/types/TaskSyncFunction.html +++ b/docs/types/TaskSyncFunction.html @@ -1,5 +1,5 @@ -TaskSyncFunction | poolifier - v3.0.7

    Type alias TaskSyncFunction<Data, Response>

    TaskSyncFunction<Data, Response>: ((data?) => Response)

    Type Parameters

    Returns Response

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/WorkerChoiceStrategy.html b/docs/types/WorkerChoiceStrategy.html index 63a2b170..25b4abe8 100644 --- a/docs/types/WorkerChoiceStrategy.html +++ b/docs/types/WorkerChoiceStrategy.html @@ -1,2 +1,2 @@ -WorkerChoiceStrategy | poolifier - v3.0.7

    Type alias WorkerChoiceStrategy

    WorkerChoiceStrategy: keyof typeof WorkerChoiceStrategies

    Worker choice strategy.

    -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +WorkerChoiceStrategy | poolifier - v3.0.8

    Type alias WorkerChoiceStrategy

    WorkerChoiceStrategy: keyof typeof WorkerChoiceStrategies

    Worker choice strategy.

    +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/WorkerType.html b/docs/types/WorkerType.html index b3b6cc14..5d1c0317 100644 --- a/docs/types/WorkerType.html +++ b/docs/types/WorkerType.html @@ -1,2 +1,2 @@ -WorkerType | poolifier - v3.0.7

    Type alias WorkerType

    WorkerType: keyof typeof WorkerTypes

    Worker type.

    -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +WorkerType | poolifier - v3.0.8

    Type alias WorkerType

    WorkerType: keyof typeof WorkerTypes

    Worker type.

    +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/types/Writable.html b/docs/types/Writable.html index 875e1b98..21b1cf48 100644 --- a/docs/types/Writable.html +++ b/docs/types/Writable.html @@ -1 +1 @@ -Writable | poolifier - v3.0.7

    Type alias Writable<T>

    Writable<T>: {
        -readonly [P in keyof T]: T[P]
    }

    Type Parameters

    • T

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +Writable | poolifier - v3.0.8

    Type alias Writable<T>

    Writable<T>: {
        -readonly [P in keyof T]: T[P]
    }

    Type Parameters

    • T

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/variables/KillBehaviors.html b/docs/variables/KillBehaviors.html index dad40fb7..17c91081 100644 --- a/docs/variables/KillBehaviors.html +++ b/docs/variables/KillBehaviors.html @@ -1,4 +1,4 @@ -KillBehaviors | poolifier - v3.0.7

    Variable KillBehaviorsConst

    KillBehaviors: Readonly<{
        HARD: "HARD";
        SOFT: "SOFT";
    }> = ...

    Enumeration of kill behaviors.

    +KillBehaviors | poolifier - v3.0.8

    Variable KillBehaviorsConst

    KillBehaviors: Readonly<{
        HARD: "HARD";
        SOFT: "SOFT";
    }> = ...

    Enumeration of kill behaviors.

    Type declaration

    • Readonly HARD: "HARD"

      If currentTime - lastActiveTime is greater than maxInactiveTime but a task is still executing or queued, then the worker will be deleted.

    • Readonly SOFT: "SOFT"

      If currentTime - lastActiveTime is greater than maxInactiveTime but a task is still executing or queued, then the worker wont be deleted.

      -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/variables/Measurements.html b/docs/variables/Measurements.html index 04c697c4..6fa53b6e 100644 --- a/docs/variables/Measurements.html +++ b/docs/variables/Measurements.html @@ -1,2 +1,2 @@ -Measurements | poolifier - v3.0.7

    Variable MeasurementsConst

    Measurements: Readonly<{
        elu: "elu";
        runTime: "runTime";
        waitTime: "waitTime";
    }> = ...

    Enumeration of measurements.

    -

    Type declaration

    • Readonly elu: "elu"
    • Readonly runTime: "runTime"
    • Readonly waitTime: "waitTime"

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +Measurements | poolifier - v3.0.8

    Variable MeasurementsConst

    Measurements: Readonly<{
        elu: "elu";
        runTime: "runTime";
        waitTime: "waitTime";
    }> = ...

    Enumeration of measurements.

    +

    Type declaration

    • Readonly elu: "elu"
    • Readonly runTime: "runTime"
    • Readonly waitTime: "waitTime"

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/variables/PoolEvents.html b/docs/variables/PoolEvents.html index f076208b..06ac53a6 100644 --- a/docs/variables/PoolEvents.html +++ b/docs/variables/PoolEvents.html @@ -1,2 +1,2 @@ -PoolEvents | poolifier - v3.0.7

    Variable PoolEventsConst

    PoolEvents: Readonly<{
        backPressure: "backPressure";
        busy: "busy";
        destroy: "destroy";
        error: "error";
        full: "full";
        ready: "ready";
        taskError: "taskError";
    }> = ...

    Enumeration of pool events.

    -

    Type declaration

    • Readonly backPressure: "backPressure"
    • Readonly busy: "busy"
    • Readonly destroy: "destroy"
    • Readonly error: "error"
    • Readonly full: "full"
    • Readonly ready: "ready"
    • Readonly taskError: "taskError"

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +PoolEvents | poolifier - v3.0.8

    Variable PoolEventsConst

    PoolEvents: Readonly<{
        backPressure: "backPressure";
        busy: "busy";
        destroy: "destroy";
        error: "error";
        full: "full";
        ready: "ready";
        taskError: "taskError";
    }> = ...

    Enumeration of pool events.

    +

    Type declaration

    • Readonly backPressure: "backPressure"
    • Readonly busy: "busy"
    • Readonly destroy: "destroy"
    • Readonly error: "error"
    • Readonly full: "full"
    • Readonly ready: "ready"
    • Readonly taskError: "taskError"

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/variables/PoolTypes.html b/docs/variables/PoolTypes.html index 0948dd98..4cc638ee 100644 --- a/docs/variables/PoolTypes.html +++ b/docs/variables/PoolTypes.html @@ -1,4 +1,4 @@ -PoolTypes | poolifier - v3.0.7

    Variable PoolTypesConst

    PoolTypes: Readonly<{
        dynamic: "dynamic";
        fixed: "fixed";
    }> = ...

    Enumeration of pool types.

    +PoolTypes | poolifier - v3.0.8

    Variable PoolTypesConst

    PoolTypes: Readonly<{
        dynamic: "dynamic";
        fixed: "fixed";
    }> = ...

    Enumeration of pool types.

    Type declaration

    • Readonly dynamic: "dynamic"

      Dynamic pool type.

    • Readonly fixed: "fixed"

      Fixed pool type.

      -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/variables/WorkerChoiceStrategies.html b/docs/variables/WorkerChoiceStrategies.html index a237edd7..844315bb 100644 --- a/docs/variables/WorkerChoiceStrategies.html +++ b/docs/variables/WorkerChoiceStrategies.html @@ -1,4 +1,4 @@ -WorkerChoiceStrategies | poolifier - v3.0.7

    Variable WorkerChoiceStrategiesConst

    WorkerChoiceStrategies: Readonly<{
        FAIR_SHARE: "FAIR_SHARE";
        INTERLEAVED_WEIGHTED_ROUND_ROBIN: "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
        LEAST_BUSY: "LEAST_BUSY";
        LEAST_ELU: "LEAST_ELU";
        LEAST_USED: "LEAST_USED";
        ROUND_ROBIN: "ROUND_ROBIN";
        WEIGHTED_ROUND_ROBIN: "WEIGHTED_ROUND_ROBIN";
    }> = ...

    Enumeration of worker choice strategies.

    +WorkerChoiceStrategies | poolifier - v3.0.8

    Variable WorkerChoiceStrategiesConst

    WorkerChoiceStrategies: Readonly<{
        FAIR_SHARE: "FAIR_SHARE";
        INTERLEAVED_WEIGHTED_ROUND_ROBIN: "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
        LEAST_BUSY: "LEAST_BUSY";
        LEAST_ELU: "LEAST_ELU";
        LEAST_USED: "LEAST_USED";
        ROUND_ROBIN: "ROUND_ROBIN";
        WEIGHTED_ROUND_ROBIN: "WEIGHTED_ROUND_ROBIN";
    }> = ...

    Enumeration of worker choice strategies.

    Type declaration

    • Readonly FAIR_SHARE: "FAIR_SHARE"

      Fair share worker selection strategy.

    • Readonly Experimental INTERLEAVED_WEIGHTED_ROUND_ROBIN: "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

      Interleaved weighted round robin worker selection strategy.

    • Readonly LEAST_BUSY: "LEAST_BUSY"

      Least busy worker selection strategy.

      @@ -6,4 +6,4 @@
    • Readonly LEAST_USED: "LEAST_USED"

      Least used worker selection strategy.

    • Readonly ROUND_ROBIN: "ROUND_ROBIN"

      Round robin worker selection strategy.

    • Readonly WEIGHTED_ROUND_ROBIN: "WEIGHTED_ROUND_ROBIN"

      Weighted round robin worker selection strategy.

      -

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file diff --git a/docs/variables/WorkerTypes.html b/docs/variables/WorkerTypes.html index e069d5c4..af4081b3 100644 --- a/docs/variables/WorkerTypes.html +++ b/docs/variables/WorkerTypes.html @@ -1,2 +1,2 @@ -WorkerTypes | poolifier - v3.0.7

    Variable WorkerTypesConst

    WorkerTypes: Readonly<{
        cluster: "cluster";
        thread: "thread";
    }> = ...

    Enumeration of worker types.

    -

    Type declaration

    • Readonly cluster: "cluster"
    • Readonly thread: "thread"

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file +WorkerTypes | poolifier - v3.0.8

    Variable WorkerTypesConst

    WorkerTypes: Readonly<{
        cluster: "cluster";
        thread: "thread";
    }> = ...

    Enumeration of worker types.

    +

    Type declaration

    • Readonly cluster: "cluster"
    • Readonly thread: "thread"

    Settings

    Member Visibility

    Theme

    Generated using TypeDoc

    \ No newline at end of file -- 2.34.1