From b83ac2ad12bdcb264f1d94b546b0c46196123e11 Mon Sep 17 00:00:00 2001 From: Documentation Bot Date: Thu, 12 Sep 2024 21:00:42 +0000 Subject: [PATCH] docs: publish documentation --- docs/assets/navigation.js | 2 +- docs/assets/search.js | 2 +- docs/classes/AbstractPool.html | 92 +++++++++--------- docs/classes/AbstractWorker.html | 50 +++++----- docs/classes/CircularBuffer.html | 16 ++-- docs/classes/ClusterWorker.html | 52 +++++----- docs/classes/DynamicClusterPool.html | 94 +++++++++---------- docs/classes/DynamicThreadPool.html | 94 +++++++++---------- docs/classes/FixedClusterPool.html | 94 +++++++++---------- docs/classes/FixedThreadPool.html | 94 +++++++++---------- docs/classes/PriorityQueue.html | 28 +++--- docs/classes/ThreadWorker.html | 52 +++++----- .../WorkerChoiceStrategiesContext.html | 24 ++--- docs/functions/availableParallelism.html | 4 +- docs/hierarchy.html | 2 +- docs/index.html | 6 +- ...tLoopUtilizationMeasurementStatistics.html | 6 +- docs/interfaces/FixedQueueNode.html | 6 +- docs/interfaces/IFixedQueue.html | 32 +++---- docs/interfaces/IPool.html | 40 ++++---- docs/interfaces/IWorker.html | 22 ++--- docs/interfaces/IWorkerChoiceStrategy.html | 18 ++-- docs/interfaces/IWorkerNode.html | 40 ++++---- docs/interfaces/MeasurementOptions.html | 6 +- docs/interfaces/MeasurementStatistics.html | 16 ++-- .../MeasurementStatisticsRequirements.html | 10 +- docs/interfaces/MessageValue.html | 44 ++++----- docs/interfaces/PoolInfo.html | 20 ++-- docs/interfaces/PoolOptions.html | 38 ++++---- docs/interfaces/PromiseResponseWrapper.html | 12 +-- docs/interfaces/StrategyData.html | 6 +- docs/interfaces/StrategyPolicy.html | 8 +- docs/interfaces/Task.html | 18 ++-- docs/interfaces/TaskFunctionObject.html | 10 +- .../TaskFunctionOperationResult.html | 6 +- docs/interfaces/TaskFunctionProperties.html | 10 +- docs/interfaces/TaskPerformance.html | 12 +-- docs/interfaces/TaskStatistics.html | 18 ++-- .../TaskStatisticsRequirements.html | 10 +- docs/interfaces/TasksQueueOptions.html | 26 ++--- .../WorkerChoiceStrategyOptions.html | 14 +-- docs/interfaces/WorkerError.html | 10 +- docs/interfaces/WorkerInfo.html | 24 ++--- docs/interfaces/WorkerNodeEventDetail.html | 6 +- docs/interfaces/WorkerNodeOptions.html | 6 +- docs/interfaces/WorkerOptions.html | 10 +- docs/interfaces/WorkerStatistics.html | 8 +- docs/interfaces/WorkerUsage.html | 12 +-- docs/types/ClusterPoolOptions.html | 4 +- docs/types/ErrorHandler.html | 4 +- docs/types/EventHandler.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/ThreadPoolOptions.html | 4 +- docs/types/WorkerChoiceStrategy.html | 4 +- docs/types/WorkerType.html | 4 +- docs/types/Writable.html | 4 +- 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 +- 73 files changed, 666 insertions(+), 664 deletions(-) diff --git a/docs/assets/navigation.js b/docs/assets/navigation.js index 66c415e0..4ca07d7e 100644 --- a/docs/assets/navigation.js +++ b/docs/assets/navigation.js @@ -1 +1 @@ -window.navigationData = "data:application/octet-stream;base64,H4sIAAAAAAAAA52Y21LbMBCG38XXTCm00JY7jlOmB1ISykWnF8LZEBVFciU5Q9rh3TtyCJYsaVfprf9/v5W1q4P9429l4dFWR9XxnbGa1XaklKh2qobZeXVU1YIZA2bXV1/N7cJZHricVkd7+++fdiLKrdIPoPOctY6RTrmuW8H0STubpUihjpJEayzo3JACGeOcrSRb8PrZn56n2FNAnMw1sCkK7C0Y74I/whQd39BB0rCxDQwYa6S50tyuvrXQQkwKZIyzzpYrpa9ilLXjdK54DWOrmYV7DuZUyU6PsKgdy3O+BGk/K9XcWC74H2a5kl+AmVbDAqQdW2a5sbw2fU4uLegZq8HsFkeHQ9g/OBwWsZvWr2oKyTyhBYNd9tYkydNRTNhOPiDuo0HosPR+cKrwyfCglCsMFjoL0NlZ9nQM4xX4qnEVT/dGbCuEEj23dX8lA67hd8vXD7dI40fhKY1h9/CdiUwb+gYM5JrtUs5UErIRKQBWJU9HMVotuIFrMI2SBm41a5pMj6etGHzTu2fMsiTSN5SARkrwOr1oQgsGmzDzkEQ4gQq8aGXtJvXq7hfUNosJbcXQBnS31V6DaUUBPfSXphlp1YC2HNKdk7ZS8BHomdILJuv0whh4KByxV4SWchi5O+TtVBLTnT3YkoxcGDJ1BmBwxE+nOddapRe9p9OY7IbWyzTEnVLd9eMMLOPpszrpLEPTc+i5aCSNK0YRLT800cAbdxIhrE7HMN5lPXpPu2r6D5j8YfP6w7u9g33/Xupa6SOTU+EfM2uar5EcV/gcx9NIziPPYnqJonziQpzAnC25ijC+VsLJjMaTKIp3xRlSPImmdFeZzHBClWJdScFlDhWIFMm1WlffIeVFKCFMVg2kAO45Fe+28WOzkvXmkByCIkMJEYP9DydaqoFYQhoTrzje5g1fvtQzG0lkoIj419QaWvAdleGm+qNXSIbmlt2JmPD8fJvdxJupJdPchYdbymCm3mQ2giTH1xHMy9JKQnqVQLipyxI6EQGkf4SkaGknic6OzpMRCFsyLlzAiGkmBAhuFj1ttll4uylfiD18+/TzH94N6jkcFQAA" \ No newline at end of file +window.navigationData = "data:application/octet-stream;base64,H4sIAAAAAAAAA52YTXPbIBCG/4vOmaZJm7TNLZ/TTD/ixk5z6PRA5HVMg0EF5InbyX/vIMcRCNjFvep99wGxy4L0429l4dFWR9XxnbGa1XaklKh2qobZeXVU1YIZA2bXV1/N7cJZHricVkd7+++fdiLKrdIPoPOctY6RTrmuW8H0STubpUihjpJEayzo3JQCGeOcrSRb8PrZn16n2FNAnMw1sCkK7C0Y74I/whSd39BB0rC5DQwYa6S50tyuvrXQQkwKZIyzHi2XSl/FKGvH6VzxGsZWMwv3HMypkp0eYVE7Ns75EqT9rFRzY7ngf5jlSn4BZloNC5B2bJnlxvLa9GNyaUHPWA1mtzg6nML+weEwid2yflVTSI4TWjDYZW9NkjwdxYTl5APiOhqEDlPvB6cSnwwPUrnCYKGzAJ1dZU/HMF6CrxqX8XRtxLZCKFFzW9dXMuAafrd8/XCLYfwofEhj2D18ZyJThr4BA7liu5QzlYRsRAqAZcnTUYxWC27gGkyjpIFbzZomU+NpKwbf1O4ZsyyJ9A0loJESvE5vmtCCwSbMPCQRTqACL1pZu0W9uvsFtc1iQlsxtAHdtdprMK0ooIf+0mFGWjWgLYd05aStFHwEeqb0gsk6vTEGHgpnuk6OFXjkopBE+wkt5TCy4eTt2CCpMwBbDsRPD3OutUpvek+nMdmG1ss0xJ1S3fXjDCzj6bM66SxD02vouWgkjStGEfU5NNHAG3cSIaxOxzDeZT16T7tq+g+Y/GHz+sO7vYN9/17qSukjk1PhHzNrmq+RHJf4HMfTSM4jz2J6iaJ84kKcwJwtuYowvlbCyczGkyiKd8UZUjyJpnRXmcx0QpViXUnBZQ4ViBTJlVqX3yHlRSghTFYNpADuORXv+vmxWcl6c0gOQZGhhIjB/ocTbdVALCGNiVccb/OGL1/qmUYSGSgi/jW1hhZ8R2W4qfroFZKhuWV3IiY8P9+mm3grtWSau/CwpQxW6k2mESQ5vo5gXrZWEtKrBMItXZbQiQgg/SMkRUs7SXR2dp6MQNiSceECRkwzIUBws+hps83G2035Quzh26ef/wB0MVfoHBUAAA==" \ No newline at end of file diff --git a/docs/assets/search.js b/docs/assets/search.js index 8ccc4dc5..cfb154dc 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 6345ae45..b375a101 100644 --- a/docs/classes/AbstractPool.html +++ b/docs/classes/AbstractPool.html @@ -1,8 +1,8 @@ -AbstractPool | poolifier - v4.2.10

Class AbstractPool<Worker, Data, Response>Abstract

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

+AbstractPool | poolifier - v4.2.11

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 (view full)

Implements

Constructors

Hierarchy (view full)

Implements

Constructors

Properties

  • filePath: string

    Path to the worker file.

  • opts: PoolOptions<Worker>

    Options for the pool.

  • OptionalmaximumNumberOfWorkers: number

    Maximum number of workers that this pool manages.

    -
  • Returns AbstractPool<Worker, Data, Response>

    Properties

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

    Returns AbstractPool<Worker, Data, Response>

    Properties

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -72,93 +72,93 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'backPressure': Emitted when the number of workers created in the pool has reached the maximum size expected and are back pressured (i.e. their tasks queue is full: queue size >= maximum queue size).
    • 'backPressureEnd': Emitted when the number of workers created in the pool has reached the maximum size expected and are no longer back pressured (i.e. their tasks queue is no longer full: queue size < maximum queue size).
    -
    filePath: string

    Path to the worker file.

    -
    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    -
    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    -

    Options for the pool.

    -
    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    +
    filePath: string

    Path to the worker file.

    +
    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    +
    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    +

    Options for the pool.

    +
    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    • key: The message id of each submitted task.
    • value: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.

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

    -
    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

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

    Pool worker nodes.

    -

    Accessors

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

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

    Pool worker nodes.

    +

    Accessors

    • get backPressure(): boolean
    • Whether the pool is back pressured or not.

      Returns boolean

      The pool back pressure boolean status.

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

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

      -

      Returns "fixed" | "dynamic"

    Methods

    • Parameters

    Methods

    • 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

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

    Returns void

    • 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

    • Hook executed before the worker task execution. +

    Returns void

    • 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

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

      +

    Returns void

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

      Returns number

      New, completely set up dynamic worker node key.

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

      Returns number

      New, completely set up worker node key.

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

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

      Type Parameters

      • Message

      Parameters

      • workerNodeKey: number

        The worker node key.

      • listener: ((message: MessageValue<Message, unknown>) => void)

        The message listener callback.

        -

      Returns void

    • Terminates the worker node given its worker node key.

      +

    Returns void

    • Terminates the worker node given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

        -

      Returns Promise<void>

    • Parameters

      • Optionaldata: Data

        The optional task input data for the specified task function. This can only be structured-cloneable data.

        +

      Returns Promise<void>

    • Parameters

      • Optionaldata: Data

        The optional task input data for the specified task function. This can only be structured-cloneable data.

      • Optionalname: string

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

      • OptionaltransferList: readonly 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 with a task function response that will be fulfilled when the task is completed.

      -
    • Gets the worker information given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

      Returns undefined | WorkerInfo

      The worker information.

      -
    • Whether the worker nodes are back pressured or not.

      Returns boolean

      Worker nodes back pressure boolean status.

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

      Returns boolean

      Worker nodes busyness boolean status.

      -
    • Returns whether the worker is the main worker or not.

      Returns boolean

      true if the worker is the main worker, false otherwise.

      -
    • Parameters

      • data: Iterable<Data>

        The tasks iterable input data for the specified task function. This can only be an iterable of structured-cloneable data.

        +
    • Parameters

      • data: Iterable<Data, any, any>

        The tasks iterable input data for the specified task function. This can only be an iterable of structured-cloneable data.

      • Optionalname: string

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

      • OptionaltransferList: readonly 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 with an array of task function responses that will be fulfilled when the tasks are completed.

      -
    • 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: MessageValue<Message, unknown>) => void)

        The message listener callback.

        -

      Returns void

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

      +

    Returns void

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

      Type Parameters

      • Message

      Parameters

      • workerNodeKey: number

        The worker node key.

      • listener: ((message: MessageValue<Message, unknown>) => void)

        The message listener callback.

        -

      Returns void

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

      Parameters

      • workerNodeKey: number

        The worker node key.

        -

      Returns void

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

      +

    Returns void

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

      Parameters

      • workerNodeKey: number

        The worker node key.

      • message: MessageValue<Data, unknown>

        The message.

      • OptionaltransferList: readonly TransferListItem[]

        The optional array of transferable objects.

        -

      Returns void

    • Parameters

      • name: string

        The name of the task function.

        +

      Returns void

    • Parameters

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

      Returns void

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

      -

      Returns void

    • Parameters

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

      Returns void

    • Conditions for dynamic worker creation.

      Returns boolean

      Whether to create a dynamic worker or not.

      -
    +

    Returns void

    diff --git a/docs/classes/AbstractWorker.html b/docs/classes/AbstractWorker.html index e0013505..b286dc93 100644 --- a/docs/classes/AbstractWorker.html +++ b/docs/classes/AbstractWorker.html @@ -1,8 +1,8 @@ -AbstractWorker | poolifier - v4.2.10

    Class AbstractWorker<MainWorker, Data, Response>Abstract

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

    +AbstractWorker | poolifier - v4.2.11

    Class AbstractWorker<MainWorker, Data, Response>Abstract

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

    Type Parameters

    • MainWorker extends MessagePort | Worker

      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 (view full)

    Constructors

    Hierarchy (view full)

    Constructors

    Properties

    activeInterval? id isMain @@ -31,50 +31,50 @@
  • mainWorker: undefined | null | 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

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    -
    id: number

    Worker id.

    -
    isMain: undefined | boolean

    Whether this is the main worker or not.

    -
    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    -
    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -
    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    -
    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

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

    -

    Methods

    Returns AbstractWorker<MainWorker, Data, Response>

    Properties

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    +
    id: number

    Worker id.

    +
    isMain: undefined | boolean

    Whether this is the main worker or not.

    +
    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    +
    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    +
    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    +
    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

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

    +

    Methods

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

      -
    • Handles the ready message sent by the main worker.

      +

    Returns void

    Returns void

    Returns void

    • Runs the given task function asynchronously.

      +

    Returns void

    • Runs the given task function synchronously.

      +

    Returns void

    • Sends a message to main worker.

      +

    Returns void

    Returns void

    +
    diff --git a/docs/classes/CircularBuffer.html b/docs/classes/CircularBuffer.html index f48fe539..8e2669e9 100644 --- a/docs/classes/CircularBuffer.html +++ b/docs/classes/CircularBuffer.html @@ -1,5 +1,5 @@ -CircularBuffer | poolifier - v4.2.10

    Class CircularBufferInternal

    Circular buffer designed for positive numbers.

    -

    Constructors

    constructor +CircularBuffer | poolifier - v4.2.11

    Class CircularBufferInternal

    Circular buffer designed for positive numbers.

    +

    Constructors

    Properties

    Methods

    empty full @@ -11,14 +11,14 @@
    defaultBufferSize
     
    -

    Properties

    size: number

    Methods

    Properties

    size: number

    Methods

    • Checks whether the buffer is empty.

      Returns boolean

      Whether the buffer is empty.

      -
    • Checks whether the buffer is full.

      Returns boolean

      Whether the buffer is full.

      -
    • Gets number from buffer.

      Returns undefined | number

      Number from buffer.

      -
    • Puts number into buffer.

      Parameters

      • number: number

        Number to put into buffer.

        -

      Returns void

    • Returns buffer as numbers' array.

      +

    Returns void

    +
    diff --git a/docs/classes/ClusterWorker.html b/docs/classes/ClusterWorker.html index 4d2e6f3d..af64601c 100644 --- a/docs/classes/ClusterWorker.html +++ b/docs/classes/ClusterWorker.html @@ -1,13 +1,13 @@ -ClusterWorker | poolifier - v4.2.10

    Class ClusterWorker<Data, Response>

    A cluster worker used by a poolifier ClusterPool.

    +ClusterWorker | poolifier - v4.2.11

    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, but the minimum number of workers will be guaranteed.

    -

    Christopher Quadflieg

    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 (view full)

    Constructors

    Hierarchy (view full)

    Constructors

    Properties

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

    Constructors

    Properties

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    -
    isMain: undefined | boolean

    Whether this is the main worker or not.

    -
    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    -
    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -
    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    -
    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

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

    -

    Accessors

    Methods

    Returns ClusterWorker<Data, Response>

    Properties

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    +
    isMain: undefined | boolean

    Whether this is the main worker or not.

    +
    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    +
    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    +
    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    +
    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

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

    +

    Accessors

    Methods

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

      -
    • Handles the ready message sent by the main worker.

      +

    Returns void

    Returns void

    Returns void

    • Runs the given task function asynchronously.

      +

    Returns void

    • Runs the given task function synchronously.

      +

    Returns void

    • Sends a message to main worker.

      +

    Returns void

    Returns void

    +
    diff --git a/docs/classes/DynamicClusterPool.html b/docs/classes/DynamicClusterPool.html index e9fa31c3..8eef572b 100644 --- a/docs/classes/DynamicClusterPool.html +++ b/docs/classes/DynamicClusterPool.html @@ -1,11 +1,11 @@ -DynamicClusterPool | poolifier - v4.2.10

    Class DynamicClusterPool<Data, Response>

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

    +DynamicClusterPool | poolifier - v4.2.11

    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.

    -

    Christopher Quadflieg

    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 (view full)

    Constructors

    Hierarchy (view full)

    Constructors

    Properties

    emitter? filePath maximumNumberOfWorkers? @@ -48,9 +48,9 @@ When the maximum number of workers is reached and workers are busy, an event is sendToWorker setDefaultTaskFunction setTasksQueueOptions +setupHook setWorkerChoiceStrategy setWorkerChoiceStrategyOptions -setupHook shallCreateDynamicWorker start workerMessageListener @@ -59,7 +59,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

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

    Returns DynamicClusterPool<Data, Response>

    Properties

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -75,92 +75,92 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'backPressure': Emitted when the number of workers created in the pool has reached the maximum size expected and are back pressured (i.e. their tasks queue is full: queue size >= maximum queue size).
    • 'backPressureEnd': Emitted when the number of workers created in the pool has reached the maximum size expected and are no longer back pressured (i.e. their tasks queue is no longer full: queue size < maximum queue size).
    -
    filePath: string

    Path to the worker file.

    -
    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    -
    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    -
    opts: PoolOptions<Worker>

    Options for the pool.

    -
    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    +
    filePath: string

    Path to the worker file.

    +
    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    +
    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    +
    opts: PoolOptions<Worker>

    Options for the pool.

    +
    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    • key: The message id of each submitted task.
    • value: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.

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

    -
    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

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

    Pool worker nodes.

    -

    Accessors

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

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

    Pool worker nodes.

    +

    Accessors

    • get backPressure(): boolean
    • Whether the pool is back pressured or not.

      Returns boolean

      The pool back pressure boolean status.

      -
    • get busy(): boolean
    • Whether the pool is busy or not.

      Returns boolean

      The pool busyness boolean status.

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

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

      -

      Returns "fixed" | "dynamic"

    • get worker(): "cluster" | "thread"
    • The worker type.

      -

      Returns "cluster" | "thread"

    Methods

    • Parameters

    • get worker(): "cluster" | "thread"
    • The worker type.

      +

      Returns "cluster" | "thread"

    Methods

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

    Returns void

    • Hook executed before the worker task execution. +

    Returns void

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

      +

    Returns void

    • Terminates the worker node given its worker node key.

      +

    Returns void

    • Parameters

      • Optionaldata: Data

        The optional task input data for the specified task function. This can only be structured-cloneable data.

      • Optionalname: string

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

      • OptionaltransferList: readonly 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 with a task function response that will be fulfilled when the task is completed.

      -
    • Parameters

      • data: Iterable<Data, any, any>

        The tasks iterable input data for the specified task function. This can only be an iterable of structured-cloneable data.

      • Optionalname: string

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

      • OptionaltransferList: readonly 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 with an array of task function responses that will be fulfilled when the tasks are completed.

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

      +

    Returns void

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

      +

    Returns void

    • Parameters

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

      Returns void

    • Parameters

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

      Returns void

    +

    Returns void

    diff --git a/docs/classes/DynamicThreadPool.html b/docs/classes/DynamicThreadPool.html index 17f2455f..2b9ad861 100644 --- a/docs/classes/DynamicThreadPool.html +++ b/docs/classes/DynamicThreadPool.html @@ -1,11 +1,11 @@ -DynamicThreadPool | poolifier - v4.2.10

    Class DynamicThreadPool<Data, Response>

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

    +DynamicThreadPool | poolifier - v4.2.11

    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.

    -

    Alessandro Pio Ardizio

    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 (view full)

    Constructors

    Hierarchy (view full)

    Constructors

    Properties

    emitter? filePath maximumNumberOfWorkers? @@ -48,9 +48,9 @@ When the maximum number of threads is reached and workers are busy, an event is sendToWorker setDefaultTaskFunction setTasksQueueOptions +setupHook setWorkerChoiceStrategy setWorkerChoiceStrategyOptions -setupHook shallCreateDynamicWorker start workerMessageListener @@ -59,7 +59,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

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

    Returns DynamicThreadPool<Data, Response>

    Properties

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -75,93 +75,93 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'backPressure': Emitted when the number of workers created in the pool has reached the maximum size expected and are back pressured (i.e. their tasks queue is full: queue size >= maximum queue size).
    • 'backPressureEnd': Emitted when the number of workers created in the pool has reached the maximum size expected and are no longer back pressured (i.e. their tasks queue is no longer full: queue size < maximum queue size).
    -
    filePath: string

    Path to the worker file.

    -
    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    -
    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    -
    opts: PoolOptions<Worker>

    Options for the pool.

    -
    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    +
    filePath: string

    Path to the worker file.

    +
    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    +
    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    +
    opts: PoolOptions<Worker>

    Options for the pool.

    +
    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    • key: The message id of each submitted task.
    • value: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.

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

    -
    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

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

    Pool worker nodes.

    -

    Accessors

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

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

    Pool worker nodes.

    +

    Accessors

    • get backPressure(): boolean
    • Whether the pool is back pressured or not.

      Returns boolean

      The pool back pressure boolean status.

      -
    • get busy(): boolean
    • Whether the pool is busy or not.

      Returns boolean

      The pool busyness boolean status.

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

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

      -

      Returns "fixed" | "dynamic"

    • get worker(): "cluster" | "thread"
    • The worker type.

      -

      Returns "cluster" | "thread"

    Methods

    • Parameters

    • get worker(): "cluster" | "thread"
    • The worker type.

      +

      Returns "cluster" | "thread"

    Methods

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

    Returns void

    • Hook executed before the worker task execution. +

    Returns void

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

      +

    Returns void

    • Terminates the worker node given its worker node key.

      +

    Returns void

    • Parameters

      • Optionaldata: Data

        The optional task input data for the specified task function. This can only be structured-cloneable data.

      • Optionalname: string

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

      • OptionaltransferList: readonly 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 with a task function response that will be fulfilled when the task is completed.

      -
    • Parameters

      • data: Iterable<Data, any, any>

        The tasks iterable input data for the specified task function. This can only be an iterable of structured-cloneable data.

      • Optionalname: string

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

      • OptionaltransferList: readonly 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 with an array of task function responses that will be fulfilled when the tasks are completed.

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

      +

    Returns void

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

      +

    Returns void

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

      Parameters

      • workerNodeKey: number

        The worker node key.

      • message: MessageValue<Data, unknown>

        The message.

      • OptionaltransferList: readonly TransferListItem[]

        The optional array of transferable objects.

        -

      Returns void

    • Parameters

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

      Returns void

    • Parameters

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

      Returns void

    +

    Returns void

    diff --git a/docs/classes/FixedClusterPool.html b/docs/classes/FixedClusterPool.html index bc619622..cf36edd2 100644 --- a/docs/classes/FixedClusterPool.html +++ b/docs/classes/FixedClusterPool.html @@ -1,9 +1,9 @@ -FixedClusterPool | poolifier - v4.2.10

    Class FixedClusterPool<Data, Response>

    A cluster pool with a fixed number of workers.

    -

    Christopher Quadflieg

    +FixedClusterPool | poolifier - v4.2.11

    Class FixedClusterPool<Data, Response>

    A cluster pool with a fixed number of workers.

    +

    Christopher Quadflieg

    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 (view full)

    Constructors

    Hierarchy (view full)

    Constructors

    Properties

  • filePath: string

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

  • opts: ClusterPoolOptions = {}

    Options for this fixed cluster pool.

  • OptionalmaximumNumberOfWorkers: number

    The maximum number of workers for this pool.

    -
  • Returns FixedClusterPool<Data, Response>

    Properties

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

    Returns FixedClusterPool<Data, Response>

    Properties

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -73,92 +73,92 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'backPressure': Emitted when the number of workers created in the pool has reached the maximum size expected and are back pressured (i.e. their tasks queue is full: queue size >= maximum queue size).
    • 'backPressureEnd': Emitted when the number of workers created in the pool has reached the maximum size expected and are no longer back pressured (i.e. their tasks queue is no longer full: queue size < maximum queue size).
    -
    filePath: string

    Path to the worker file.

    -
    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    -
    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    -
    opts: PoolOptions<Worker>

    Options for the pool.

    -
    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    +
    filePath: string

    Path to the worker file.

    +
    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    +
    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    +
    opts: PoolOptions<Worker>

    Options for the pool.

    +
    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    • key: The message id of each submitted task.
    • value: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.

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

    -
    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

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

    Pool worker nodes.

    -

    Accessors

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

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

    Pool worker nodes.

    +

    Accessors

    • get backPressure(): boolean
    • Whether the pool is back pressured or not.

      Returns boolean

      The pool back pressure boolean status.

      -
    • get busy(): boolean
    • Whether the pool is busy or not.

      Returns boolean

      The pool busyness boolean status.

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

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

      -

      Returns "fixed" | "dynamic"

    • get worker(): "cluster" | "thread"
    • The worker type.

      -

      Returns "cluster" | "thread"

    Methods

    • Parameters

    • get worker(): "cluster" | "thread"
    • The worker type.

      +

      Returns "cluster" | "thread"

    Methods

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

    Returns void

    • Hook executed before the worker task execution. +

    Returns void

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

      +

    Returns void

    • Terminates the worker node given its worker node key.

      +

    Returns void

    • Parameters

      • Optionaldata: Data

        The optional task input data for the specified task function. This can only be structured-cloneable data.

      • Optionalname: string

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

      • OptionaltransferList: readonly 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 with a task function response that will be fulfilled when the task is completed.

      -
    • Parameters

      • data: Iterable<Data, any, any>

        The tasks iterable input data for the specified task function. This can only be an iterable of structured-cloneable data.

      • Optionalname: string

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

      • OptionaltransferList: readonly 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 with an array of task function responses that will be fulfilled when the tasks are completed.

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

      +

    Returns void

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

      +

    Returns void

    • Parameters

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

      Returns void

    • Parameters

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

      Returns void

    +

    Returns void

    diff --git a/docs/classes/FixedThreadPool.html b/docs/classes/FixedThreadPool.html index 9caa3c50..062f6793 100644 --- a/docs/classes/FixedThreadPool.html +++ b/docs/classes/FixedThreadPool.html @@ -1,9 +1,9 @@ -FixedThreadPool | poolifier - v4.2.10

    Class FixedThreadPool<Data, Response>

    A thread pool with a fixed number of threads.

    -

    Alessandro Pio Ardizio

    +FixedThreadPool | poolifier - v4.2.11

    Class FixedThreadPool<Data, Response>

    A thread pool with a fixed number of threads.

    +

    Alessandro Pio Ardizio

    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 (view full)

    Constructors

    Hierarchy (view full)

    Constructors

    Properties

  • filePath: string

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

  • opts: ThreadPoolOptions = {}

    Options for this fixed thread pool.

  • OptionalmaximumNumberOfThreads: number

    The maximum number of threads for this pool.

    -
  • Returns FixedThreadPool<Data, Response>

    Properties

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

    Returns FixedThreadPool<Data, Response>

    Properties

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -73,93 +73,93 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'backPressure': Emitted when the number of workers created in the pool has reached the maximum size expected and are back pressured (i.e. their tasks queue is full: queue size >= maximum queue size).
    • 'backPressureEnd': Emitted when the number of workers created in the pool has reached the maximum size expected and are no longer back pressured (i.e. their tasks queue is no longer full: queue size < maximum queue size).
    -
    filePath: string

    Path to the worker file.

    -
    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    -
    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    -
    opts: PoolOptions<Worker>

    Options for the pool.

    -
    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    +
    filePath: string

    Path to the worker file.

    +
    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    +
    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    +
    opts: PoolOptions<Worker>

    Options for the pool.

    +
    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    • key: The message id of each submitted task.
    • value: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.

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

    -
    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

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

    Pool worker nodes.

    -

    Accessors

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

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

    Pool worker nodes.

    +

    Accessors

    • get backPressure(): boolean
    • Whether the pool is back pressured or not.

      Returns boolean

      The pool back pressure boolean status.

      -
    • get busy(): boolean
    • Whether the pool is busy or not.

      Returns boolean

      The pool busyness boolean status.

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

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

      -

      Returns "fixed" | "dynamic"

    • get worker(): "cluster" | "thread"
    • The worker type.

      -

      Returns "cluster" | "thread"

    Methods

    • Parameters

    • get worker(): "cluster" | "thread"
    • The worker type.

      +

      Returns "cluster" | "thread"

    Methods

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

    Returns void

    • Hook executed before the worker task execution. +

    Returns void

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

      +

    Returns void

    • Terminates the worker node given its worker node key.

      +

    Returns void

    • Parameters

      • Optionaldata: Data

        The optional task input data for the specified task function. This can only be structured-cloneable data.

      • Optionalname: string

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

      • OptionaltransferList: readonly 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 with a task function response that will be fulfilled when the task is completed.

      -
    • Parameters

      • data: Iterable<Data, any, any>

        The tasks iterable input data for the specified task function. This can only be an iterable of structured-cloneable data.

      • Optionalname: string

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

      • OptionaltransferList: readonly 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 with an array of task function responses that will be fulfilled when the tasks are completed.

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

      +

    Returns void

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

      +

    Returns void

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

      Parameters

      • workerNodeKey: number

        The worker node key.

      • message: MessageValue<Data, unknown>

        The message.

      • OptionaltransferList: readonly TransferListItem[]

        The optional array of transferable objects.

        -

      Returns void

    • Parameters

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

      Returns void

    • Parameters

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

      Returns void

    +

    Returns void

    diff --git a/docs/classes/PriorityQueue.html b/docs/classes/PriorityQueue.html index 6c65fd0c..4bea5add 100644 --- a/docs/classes/PriorityQueue.html +++ b/docs/classes/PriorityQueue.html @@ -1,6 +1,6 @@ -PriorityQueue | poolifier - v4.2.10

    Class PriorityQueue<T>Internal

    Priority queue.

    +PriorityQueue | poolifier - v4.2.11

    Class PriorityQueue<T>Internal

    Priority queue.

    Type Parameters

    • T

      Type of priority queue data.

      -

    Constructors

    Constructors

    Properties

    Accessors

    buckets enablePriority @@ -19,24 +19,24 @@
    false
     
    -

    Properties

    maxSize: number

    The priority queue maximum size.

    -

    Accessors

    Properties

    maxSize: number

    The priority queue maximum size.

    +

    Accessors

    • get buckets(): number
    • The number of filled prioritized buckets.

      Returns number

      The number of filled prioritized buckets.

      -
    • get size(): number
    • The priority queue size.

      +

    Returns void

    Methods

    Methods

    • Dequeue data from the priority queue.

      Parameters

      • Optionalbucket: number

        The prioritized bucket to dequeue from.

      Returns undefined | T

      The dequeued data or undefined if the priority queue is empty.

      -
    • Enqueue data into the priority queue.

      Parameters

      • data: T

        Data to enqueue.

      • Optionalpriority: number

        Priority of the data. Lower values have higher priority.

      Returns number

      The new size of the priority queue.

      -
    +
    diff --git a/docs/classes/ThreadWorker.html b/docs/classes/ThreadWorker.html index 33480d80..1d3738b9 100644 --- a/docs/classes/ThreadWorker.html +++ b/docs/classes/ThreadWorker.html @@ -1,13 +1,13 @@ -ThreadWorker | poolifier - v4.2.10

    Class ThreadWorker<Data, Response>

    A thread worker used by a poolifier ThreadPool.

    +ThreadWorker | poolifier - v4.2.11

    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, but the minimum number of workers will be guaranteed.

    -

    Alessandro Pio Ardizio

    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 (view full)

    Constructors

    Hierarchy (view full)

    Constructors

    Properties

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

    Constructors

    Properties

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    -
    isMain: undefined | boolean

    Whether this is the main worker or not.

    -
    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    -
    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -
    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    -
    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

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

    -

    Accessors

    Methods

    Returns ThreadWorker<Data, Response>

    Properties

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    +
    isMain: undefined | boolean

    Whether this is the main worker or not.

    +
    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    +
    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    +
    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    +
    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

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

    +

    Accessors

    Methods

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

      -
    • Handles the ready message sent by the main worker.

      +

    Returns void

    Returns void

    Returns void

    • Runs the given task function asynchronously.

      +

    Returns void

    • Runs the given task function synchronously.

      +

    Returns void

    • Sends a message to main worker.

      +

    Returns void

    Returns void

    +
    diff --git a/docs/classes/WorkerChoiceStrategiesContext.html b/docs/classes/WorkerChoiceStrategiesContext.html index 5d7861ef..73c7da4e 100644 --- a/docs/classes/WorkerChoiceStrategiesContext.html +++ b/docs/classes/WorkerChoiceStrategiesContext.html @@ -1,8 +1,8 @@ -WorkerChoiceStrategiesContext | poolifier - v4.2.10

    Class WorkerChoiceStrategiesContext<Worker, Data, Response>Internal

    The worker choice strategies context.

    +WorkerChoiceStrategiesContext | poolifier - v4.2.11

    Class WorkerChoiceStrategiesContext<Worker, Data, Response>Internal

    The worker choice strategies 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.

      -

    Constructors

    Constructors

    Properties

    Methods

    execute getPolicy @@ -19,30 +19,30 @@

    Returns WorkerChoiceStrategiesContext<Worker, Data, Response>

    [WorkerChoiceStrategies.ROUND_ROBIN]
     
    -

    Properties

    retriesCount: number

    The number of worker choice strategies execution retries.

    -

    Methods

    Properties

    retriesCount: number

    The number of worker choice strategies execution retries.

    +

    Methods

    • Executes the given worker choice strategy in the context algorithm.

      Parameters

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

        The worker choice strategy algorithm to execute.

      Returns number

      The key of the worker node.

      this.defaultWorkerChoiceStrategy
       

      https://nodejs.org/api/errors.html#class-error If after computed retries the worker node key is null or undefined.

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

      Parameters

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

        The default worker choice strategy to set.

      • Optionalopts: WorkerChoiceStrategyOptions

        The worker choice strategy options.

        -

      Returns void

    • Sets the active worker choice strategies in the context options.

      +

    Returns void

    • Synchronizes the active worker choice strategies in the context with the given worker choice strategies.

      +

    Returns void

    • Synchronizes the active worker choice strategies in the context with the given worker choice strategies.

      Parameters

      • workerChoiceStrategies: Set<
            | "FAIR_SHARE"
            | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
            | "LEAST_BUSY"
            | "LEAST_ELU"
            | "LEAST_USED"
            | "ROUND_ROBIN"
            | "WEIGHTED_ROUND_ROBIN">

        The worker choice strategies to synchronize.

      • Optionalopts: WorkerChoiceStrategyOptions

        The worker choice strategy options.

        -

      Returns void

    • Updates the worker node key in the active worker choice strategies in the context internals.

      +

    Returns void

    +
    diff --git a/docs/functions/availableParallelism.html b/docs/functions/availableParallelism.html index f6afc471..c7396822 100644 --- a/docs/functions/availableParallelism.html +++ b/docs/functions/availableParallelism.html @@ -1,4 +1,4 @@ -availableParallelism | poolifier - v4.2.10

    Function availableParallelism

    Returns safe host OS optimized estimate of the default amount of parallelism a pool should use. +availableParallelism | poolifier - v4.2.11

    Function availableParallelism

    Returns safe host OS optimized estimate of the default amount of parallelism a pool should use. Always returns a value greater than zero.

    • Returns number

      The host OS optimized maximum pool size.

      -
    +
    diff --git a/docs/hierarchy.html b/docs/hierarchy.html index 4969c181..651cc5f0 100644 --- a/docs/hierarchy.html +++ b/docs/hierarchy.html @@ -1 +1 @@ -poolifier - v4.2.10
    +poolifier - v4.2.11
    diff --git a/docs/index.html b/docs/index.html index e08149a3..21d469b9 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,4 +1,4 @@ -poolifier - v4.2.10

    poolifier - v4.2.10

    Index

    Classes

    AbstractPool +poolifier - v4.2.11
    +
    diff --git a/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html b/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html index a0ea0f54..16eac12d 100644 --- a/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html +++ b/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html @@ -1,5 +1,5 @@ -EventLoopUtilizationMeasurementStatistics | poolifier - v4.2.10

    Interface EventLoopUtilizationMeasurementStatisticsInternal

    Event loop utilization measurement statistics.

    -
    interface EventLoopUtilizationMeasurementStatistics {
        active: MeasurementStatistics;
        idle: MeasurementStatistics;
        utilization?: number;
    }

    Properties

    active +EventLoopUtilizationMeasurementStatistics | poolifier - v4.2.11

    Interface EventLoopUtilizationMeasurementStatisticsInternal

    Event loop utilization measurement statistics.

    +
    interface EventLoopUtilizationMeasurementStatistics {
        active: MeasurementStatistics;
        idle: MeasurementStatistics;
        utilization?: number;
    }

    Properties

    utilization?: number
    +

    Properties

    utilization?: number
    diff --git a/docs/interfaces/FixedQueueNode.html b/docs/interfaces/FixedQueueNode.html index 90891d2a..71be4014 100644 --- a/docs/interfaces/FixedQueueNode.html +++ b/docs/interfaces/FixedQueueNode.html @@ -1,5 +1,5 @@ -FixedQueueNode | poolifier - v4.2.10

    Interface FixedQueueNode<T>Internal

    Fixed queue node.

    +FixedQueueNode | poolifier - v4.2.11

    Interface FixedQueueNode<T>Internal

    Fixed queue node.

    interface FixedQueueNode<T> {
        data: T;
        priority: number;
    }

    Type Parameters

    • T

      Type of fixed queue node data.

      -

    Properties

    Properties

    Properties

    data: T
    priority: number
    +

    Properties

    data: T
    priority: number
    diff --git a/docs/interfaces/IFixedQueue.html b/docs/interfaces/IFixedQueue.html index 9f3d4e5f..4eeef1be 100644 --- a/docs/interfaces/IFixedQueue.html +++ b/docs/interfaces/IFixedQueue.html @@ -1,6 +1,6 @@ -IFixedQueue | poolifier - v4.2.10

    Interface IFixedQueue<T>Internal

    Fixed queue.

    -
    interface IFixedQueue<T> {
        [iterator]: (() => Iterator<T, any, undefined>);
        capacity: number;
        clear: (() => void);
        dequeue: (() => undefined | T);
        empty: (() => boolean);
        enqueue: ((data: T, priority?: number) => number);
        full: (() => boolean);
        get: ((index: number) => undefined | T);
        nodeArray: FixedQueueNode<T>[];
        size: number;
    }

    Type Parameters

    • T

      Type of fixed queue data.

      -

    Properties

    [iterator] +IFixedQueue | poolifier - v4.2.11

    Interface IFixedQueue<T>Internal

    Fixed queue.

    +
    interface IFixedQueue<T> {
        [iterator]: (() => Iterator<T, any, any>);
        capacity: number;
        clear: (() => void);
        dequeue: (() => undefined | T);
        empty: (() => boolean);
        enqueue: ((data: T, priority?: number) => number);
        full: (() => boolean);
        get: ((index: number) => undefined | T);
        nodeArray: FixedQueueNode<T>[];
        size: number;
    }

    Type Parameters

    • T

      Type of fixed queue data.

      +

    Properties

    Properties

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

    Returns an iterator for the fixed queue.

    -

    Type declaration

      • (): Iterator<T, any, undefined>
      • Returns Iterator<T, any, undefined>

        An iterator for the fixed queue.

        -
    capacity: number

    The fixed queue capacity.

    -
    clear: (() => void)

    Clears the fixed queue.

    -
    dequeue: (() => undefined | T)

    Dequeue data from the fixed queue.

    +

    Properties

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

    Returns an iterator for the fixed queue.

    +

    Type declaration

      • (): Iterator<T, any, any>
      • Returns Iterator<T, any, any>

        An iterator for the fixed queue.

        +
    capacity: number

    The fixed queue capacity.

    +
    clear: (() => void)

    Clears the fixed queue.

    +
    dequeue: (() => undefined | T)

    Dequeue data from the fixed queue.

    Type declaration

      • (): undefined | T
      • Returns undefined | T

        The dequeued data or undefined if the fixed queue is empty.

        -
    empty: (() => boolean)

    Checks if the fixed queue is empty.

    +
    empty: (() => boolean)

    Checks if the fixed queue is empty.

    Type declaration

      • (): boolean
      • Returns boolean

        true if the fixed queue is empty, false otherwise.

        -
    enqueue: ((data: T, priority?: number) => number)

    Enqueue data into the fixed queue.

    +
    enqueue: ((data: T, priority?: number) => number)

    Enqueue data into the fixed queue.

    Type declaration

      • (data, priority?): number
      • Parameters

        • data: T

          Data to enqueue.

        • Optionalpriority: number

          Priority of the data. Lower values have higher priority.

        Returns number

        The new size of the fixed queue.

    If the fixed queue is full.

    -
    full: (() => boolean)

    Checks if the fixed queue is full.

    +
    full: (() => boolean)

    Checks if the fixed queue is full.

    Type declaration

      • (): boolean
      • Returns boolean

        true if the fixed queue is full, false otherwise.

        -
    get: ((index: number) => undefined | T)

    Gets data from the fixed queue.

    +
    get: ((index: number) => undefined | T)

    Gets data from the fixed queue.

    Type declaration

      • (index): undefined | T
      • Parameters

        • index: number

          The index of the data to get.

        Returns undefined | T

        The data at the index or undefined if the fixed queue is empty or the index is out of bounds.

        -
    nodeArray: FixedQueueNode<T>[]

    The fixed queue node array.

    -
    size: number

    The fixed queue size.

    -
    +
    nodeArray: FixedQueueNode<T>[]

    The fixed queue node array.

    +
    size: number

    The fixed queue size.

    +
    diff --git a/docs/interfaces/IPool.html b/docs/interfaces/IPool.html index 21cc67ee..e0358eb1 100644 --- a/docs/interfaces/IPool.html +++ b/docs/interfaces/IPool.html @@ -1,8 +1,8 @@ -IPool | poolifier - v4.2.10

    Interface IPool<Worker, Data, Response>

    Contract definition for a poolifier pool.

    -
    interface IPool<Worker, Data, Response> {
        addTaskFunction: ((name: string, fn: TaskFunction<Data, Response> | TaskFunctionObject<Data, Response>) => Promise<boolean>);
        destroy: (() => Promise<void>);
        emitter?: EventEmitterAsyncResource;
        enableTasksQueue: ((enable: boolean, tasksQueueOptions?: TasksQueueOptions) => void);
        execute: ((data?: Data, name?: string, transferList?: readonly TransferListItem[]) => Promise<Response>);
        hasTaskFunction: ((name: string) => boolean);
        info: PoolInfo;
        listTaskFunctionsProperties: (() => TaskFunctionProperties[]);
        mapExecute: ((data: Iterable<Data>, name?: string, transferList?: readonly TransferListItem[]) => Promise<Response[]>);
        removeTaskFunction: ((name: string) => Promise<boolean>);
        setDefaultTaskFunction: ((name: string) => Promise<boolean>);
        setTasksQueueOptions: ((tasksQueueOptions: TasksQueueOptions) => void);
        setWorkerChoiceStrategy: ((workerChoiceStrategy:
            | "FAIR_SHARE"
            | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
            | "LEAST_BUSY"
            | "LEAST_ELU"
            | "LEAST_USED"
            | "ROUND_ROBIN"
            | "WEIGHTED_ROUND_ROBIN", workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions) => void);
        setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions: WorkerChoiceStrategyOptions) => boolean);
        start: (() => void);
        workerNodes: IWorkerNode<Worker, Data>[];
    }

    Type Parameters

    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.

    https://nodejs.org/api/errors.html#class-typeerror If the name parameter is not a string or an empty string.

    https://nodejs.org/api/errors.html#class-typeerror If the fn parameter is not a function or task function object.

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

    Terminates all workers in this pool.

    -
    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

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

    Terminates all workers in this pool.

    +
    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -42,39 +42,39 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'backPressure': Emitted when the number of workers created in the pool has reached the maximum size expected and are back pressured (i.e. their tasks queue is full: queue size >= maximum queue size).
    • 'backPressureEnd': Emitted when the number of workers created in the pool has reached the maximum size expected and are no longer back pressured (i.e. their tasks queue is no longer full: queue size < maximum queue size).
    -
    enableTasksQueue: ((enable: boolean, tasksQueueOptions?: TasksQueueOptions) => void)

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

    +
    enableTasksQueue: ((enable: boolean, tasksQueueOptions?: TasksQueueOptions) => void)

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

    Type declaration

      • (enable, tasksQueueOptions?): void
      • Parameters

        • enable: boolean

          Whether to enable or disable the worker node tasks queue.

        • OptionaltasksQueueOptions: TasksQueueOptions

          The worker node tasks queue options.

          -

        Returns void

    execute: ((data?: Data, name?: string, transferList?: readonly TransferListItem[]) => Promise<Response>)

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

    +

    Returns void

    execute: ((data?: Data, name?: string, transferList?: readonly TransferListItem[]) => Promise<Response>)

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

    Type declaration

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

        • Optionaldata: Data

          The optional task input data for the specified task function. This can only be structured-cloneable data.

        • Optionalname: string

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

        • OptionaltransferList: readonly 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 with a task function response that will be fulfilled when the task is completed.

        -
    hasTaskFunction: ((name: string) => boolean)

    Whether the specified task function exists in this pool.

    +
    hasTaskFunction: ((name: string) => boolean)

    Whether the specified task function exists in this pool.

    Type declaration

      • (name): boolean
      • Parameters

        • name: string

          The name of the task function.

        Returns boolean

        true if the task function exists, false otherwise.

        -
    info: PoolInfo

    Pool information.

    -
    listTaskFunctionsProperties: (() => TaskFunctionProperties[])

    Lists the properties of task functions available in this pool.

    +
    info: PoolInfo

    Pool information.

    +
    listTaskFunctionsProperties: (() => TaskFunctionProperties[])

    Lists the properties of task functions available in this pool.

    Type declaration

    mapExecute: ((data: Iterable<Data>, name?: string, transferList?: readonly TransferListItem[]) => Promise<Response[]>)

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

    -

    Type declaration

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

        • data: Iterable<Data>

          The tasks iterable input data for the specified task function. This can only be an iterable of structured-cloneable data.

          +
    mapExecute: ((data: Iterable<Data, any, any>, name?: string, transferList?: readonly TransferListItem[]) => Promise<Response[]>)

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

    +

    Type declaration

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

        • data: Iterable<Data, any, any>

          The tasks iterable input data for the specified task function. This can only be an iterable of structured-cloneable data.

        • Optionalname: string

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

        • OptionaltransferList: readonly 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 with an array of task function responses that will be fulfilled when the tasks are completed.

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

    Removes a task function from this pool.

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

    Removes a task function from this pool.

    Type declaration

      • (name): Promise<boolean>
      • Parameters

        • name: string

          The name of the task function.

        Returns Promise<boolean>

        true if the task function was removed, false otherwise.

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

    Sets the default task function in this pool.

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

    Sets the default task function in this pool.

    Type declaration

      • (name): Promise<boolean>
      • Parameters

        • name: string

          The name of the task function.

        Returns Promise<boolean>

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

        -
    setTasksQueueOptions: ((tasksQueueOptions: TasksQueueOptions) => void)

    Sets the worker node tasks queue options in this pool.

    +
    setTasksQueueOptions: ((tasksQueueOptions: TasksQueueOptions) => void)

    Sets the worker node tasks queue options in this pool.

    Type declaration

      • (tasksQueueOptions): void
      • Parameters

        Returns void

    setWorkerChoiceStrategy: ((workerChoiceStrategy:
        | "FAIR_SHARE"
        | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
        | "LEAST_BUSY"
        | "LEAST_ELU"
        | "LEAST_USED"
        | "ROUND_ROBIN"
        | "WEIGHTED_ROUND_ROBIN", workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions) => void)

    Sets the default worker choice strategy in this pool.

    +

    Returns void

    setWorkerChoiceStrategy: ((workerChoiceStrategy:
        | "FAIR_SHARE"
        | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
        | "LEAST_BUSY"
        | "LEAST_ELU"
        | "LEAST_USED"
        | "ROUND_ROBIN"
        | "WEIGHTED_ROUND_ROBIN", workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions) => void)

    Sets the default worker choice strategy in this pool.

    Type declaration

      • (workerChoiceStrategy, workerChoiceStrategyOptions?): void
      • Parameters

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

          The default worker choice strategy.

        • OptionalworkerChoiceStrategyOptions: WorkerChoiceStrategyOptions

          The worker choice strategy options.

          -

        Returns void

    setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions: WorkerChoiceStrategyOptions) => boolean)

    Sets the worker choice strategy options in this pool.

    +

    Returns void

    setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions: WorkerChoiceStrategyOptions) => boolean)

    Sets the worker choice strategy options in this pool.

    Type declaration

      • (workerChoiceStrategyOptions): boolean
      • Parameters

        Returns boolean

        true if the worker choice strategy options were set, false otherwise.

        -
    start: (() => void)

    Starts the minimum number of workers in this pool.

    -
    workerNodes: IWorkerNode<Worker, Data>[]

    Pool worker nodes.

    -
    +
    start: (() => void)

    Starts the minimum number of workers in this pool.

    +
    workerNodes: IWorkerNode<Worker, Data>[]

    Pool worker nodes.

    +
    diff --git a/docs/interfaces/IWorker.html b/docs/interfaces/IWorker.html index 8bf5349d..b6a7a730 100644 --- a/docs/interfaces/IWorker.html +++ b/docs/interfaces/IWorker.html @@ -1,5 +1,5 @@ -IWorker | poolifier - v4.2.10

    Interface IWorker

    Worker interface.

    -
    interface IWorker {
        disconnect?: (() => void);
        id?: number;
        kill?: ((signal?: string) => void);
        on: ((event: string, handler: EventHandler<IWorker>) => this);
        once: ((event: string, handler: EventHandler<IWorker>) => this);
        terminate?: (() => Promise<number>);
        threadId?: number;
        unref?: (() => void);
        [captureRejectionSymbol]?<K>(error: Error, event: string | symbol, ...args: AnyRest): void;
        addListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        emit<K>(eventName: string | symbol, ...args: AnyRest): boolean;
        eventNames(): (string | symbol)[];
        getMaxListeners(): number;
        listenerCount<K>(eventName: string | symbol, listener?: Function): number;
        listeners<K>(eventName: string | symbol): Function[];
        off<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        prependListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        prependOnceListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        rawListeners<K>(eventName: string | symbol): Function[];
        removeAllListeners(eventName?: string | symbol): this;
        removeListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        setMaxListeners(n: number): this;
    }

    Hierarchy

    • EventEmitter
      • IWorker

    Properties

    disconnect? +IWorker | poolifier - v4.2.11

    Interface IWorker

    Worker interface.

    +
    interface IWorker {
        disconnect?: (() => void);
        id?: number;
        kill?: ((signal?: string) => void);
        on: ((event: string, handler: EventHandler<IWorker>) => this);
        once: ((event: string, handler: EventHandler<IWorker>) => this);
        terminate?: (() => Promise<number>);
        threadId?: number;
        unref?: (() => void);
        [captureRejectionSymbol]?<K>(error: Error, event: string | symbol, ...args: AnyRest): void;
        addListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        emit<K>(eventName: string | symbol, ...args: AnyRest): boolean;
        eventNames(): (string | symbol)[];
        getMaxListeners(): number;
        listenerCount<K>(eventName: string | symbol, listener?: Function): number;
        listeners<K>(eventName: string | symbol): Function[];
        off<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        prependListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        prependOnceListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        rawListeners<K>(eventName: string | symbol): Function[];
        removeAllListeners(eventName?: string | symbol): this;
        removeListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        setMaxListeners(n: number): this;
    }

    Hierarchy

    • EventEmitter
      • IWorker

    Properties

    Properties

    disconnect?: (() => void)

    Cluster worker disconnect.

    -
    id?: number

    Cluster worker id.

    -
    kill?: ((signal?: string) => void)

    Cluster worker kill.

    -
    on: ((event: string, handler: EventHandler<IWorker>) => this)

    Registers an event handler.

    +
    id?: number

    Cluster worker id.

    +
    kill?: ((signal?: string) => void)

    Cluster worker kill.

    +
    on: ((event: string, handler: EventHandler<IWorker>) => this)

    Registers an event handler.

    Type declaration

      • (event, handler): this
      • Parameters

        Returns this

    once: ((event: string, handler: EventHandler<IWorker>) => this)

    Registers once an event handler.

    +

    Returns this

    once: ((event: string, handler: EventHandler<IWorker>) => this)

    Registers once an event handler.

    Type declaration

      • (event, handler): this
      • Parameters

        Returns this

    terminate?: (() => Promise<number>)

    Stop all JavaScript execution in the worker thread as soon as possible. +

    Returns this

    terminate?: (() => Promise<number>)

    Stop all JavaScript execution in the worker thread as soon as possible. Returns a Promise for the exit code that is fulfilled when the 'exit' event is emitted.

    -
    threadId?: number

    Worker thread worker id.

    -
    unref?: (() => void)

    Calling unref() on a worker allows the thread to exit if this is the only +

    threadId?: number

    Worker thread worker id.

    +
    unref?: (() => void)

    Calling unref() on a worker allows the thread to exit if this is the only active handle in the event system. If the worker is already unref()ed callingunref() again has no effect.

    v10.5.0

    -

    Methods

    • Type Parameters

      • K

      Parameters

      • error: Error
      • event: string | symbol
      • Rest...args: AnyRest

      Returns void

    Methods

    • Type Parameters

      • K

      Parameters

      • error: Error
      • event: string | symbol
      • Rest...args: AnyRest

      Returns void

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

      Type Parameters

      • K

      Parameters

      • eventName: string | symbol
      • listener: ((...args: any[]) => void)
          • (...args): void
          • Parameters

            • Rest...args: any[]

            Returns void

      Returns this

      v0.1.26

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

      @@ -132,4 +132,4 @@ memory leaks. The emitter.setMaxListeners() method allows the limit modified for this specific EventEmitter instance. The value can be set to Infinity (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 this

      v0.3.5

      -
    +
    diff --git a/docs/interfaces/IWorkerChoiceStrategy.html b/docs/interfaces/IWorkerChoiceStrategy.html index 80b18a45..dcc7f4b2 100644 --- a/docs/interfaces/IWorkerChoiceStrategy.html +++ b/docs/interfaces/IWorkerChoiceStrategy.html @@ -1,5 +1,5 @@ -IWorkerChoiceStrategy | poolifier - v4.2.10

    Interface IWorkerChoiceStrategyInternal

    Worker choice strategy interface.

    -
    interface IWorkerChoiceStrategy {
        choose: (() => undefined | number);
        remove: ((workerNodeKey: number) => boolean);
        reset: (() => boolean);
        setOptions: ((opts: undefined | WorkerChoiceStrategyOptions) => void);
        strategyPolicy: StrategyPolicy;
        taskStatisticsRequirements: TaskStatisticsRequirements;
        update: ((workerNodeKey: number) => boolean);
    }

    Properties

    choose +IWorkerChoiceStrategy | poolifier - v4.2.11

    Interface IWorkerChoiceStrategyInternal

    Worker choice strategy interface.

    +
    interface IWorkerChoiceStrategy {
        choose: (() => undefined | number);
        remove: ((workerNodeKey: number) => boolean);
        reset: (() => boolean);
        setOptions: ((opts: undefined | WorkerChoiceStrategyOptions) => void);
        strategyPolicy: StrategyPolicy;
        taskStatisticsRequirements: TaskStatisticsRequirements;
        update: ((workerNodeKey: number) => boolean);
    }

    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.

    Type declaration

      • (): undefined | number
      • Returns undefined | number

        The worker node key or undefined.

        -
    remove: ((workerNodeKey: number) => boolean)

    Removes the worker node key from strategy internals.

    +
    remove: ((workerNodeKey: number) => boolean)

    Removes the worker node key from strategy internals.

    Type declaration

      • (workerNodeKey): boolean
      • Parameters

        • workerNodeKey: number

          The worker node key.

        Returns boolean

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

        -
    reset: (() => boolean)

    Resets strategy internals.

    +
    reset: (() => boolean)

    Resets strategy internals.

    Type declaration

      • (): boolean
      • Returns boolean

        true if the reset is successful, false otherwise.

        -
    setOptions: ((opts: undefined | WorkerChoiceStrategyOptions) => void)

    Sets the worker choice strategy options.

    +
    setOptions: ((opts: undefined | WorkerChoiceStrategyOptions) => void)

    Sets the worker choice strategy options.

    Type declaration

    strategyPolicy: StrategyPolicy

    Strategy policy.

    -
    taskStatisticsRequirements: TaskStatisticsRequirements

    Tasks statistics requirements.

    -
    update: ((workerNodeKey: number) => boolean)

    Updates the worker node key strategy internals. +

    Returns void

    strategyPolicy: StrategyPolicy

    Strategy policy.

    +
    taskStatisticsRequirements: TaskStatisticsRequirements

    Tasks statistics requirements.

    +
    update: ((workerNodeKey: number) => boolean)

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

    Type declaration

      • (workerNodeKey): boolean
      • Parameters

        • workerNodeKey: number

        Returns boolean

        true if the update is successful, false otherwise.

        -
    +
    diff --git a/docs/interfaces/IWorkerNode.html b/docs/interfaces/IWorkerNode.html index d80f1eb6..cca603a8 100644 --- a/docs/interfaces/IWorkerNode.html +++ b/docs/interfaces/IWorkerNode.html @@ -1,7 +1,7 @@ -IWorkerNode | poolifier - v4.2.10

    Interface IWorkerNode<Worker, Data>Internal

    Worker node interface.

    +IWorkerNode | poolifier - v4.2.11

    Interface IWorkerNode<Worker, Data>Internal

    Worker node interface.

    interface IWorkerNode<Worker, Data> {
        clearTasksQueue: (() => void);
        deleteTaskFunctionWorkerUsage: ((name: string) => boolean);
        dequeueLastPrioritizedTask: (() => undefined | Task<Data>);
        dequeueTask: ((bucket?: number) => undefined | Task<Data>);
        enqueueTask: ((task: Task<Data>) => number);
        getTaskFunctionWorkerUsage: ((name: string) => undefined | WorkerUsage);
        info: WorkerInfo;
        messageChannel?: MessageChannel;
        registerOnceWorkerEventHandler: ((event: string, handler: EventHandler<Worker>) => void);
        registerWorkerEventHandler: ((event: string, handler: EventHandler<Worker>) => void);
        setTasksQueuePriority: ((enablePriority: boolean) => void);
        strategyData?: StrategyData;
        tasksQueueBackPressureSize: number;
        tasksQueueSize: (() => number);
        terminate: (() => Promise<void>);
        usage: WorkerUsage;
        worker: Worker;
        [captureRejectionSymbol]?<K>(error: Error, event: string | symbol, ...args: AnyRest): void;
        addListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        emit<K>(eventName: string | symbol, ...args: AnyRest): boolean;
        eventNames(): (string | symbol)[];
        getMaxListeners(): number;
        listenerCount<K>(eventName: string | symbol, listener?: Function): number;
        listeners<K>(eventName: string | symbol): Function[];
        off<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        on<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        once<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        prependListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        prependOnceListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        rawListeners<K>(eventName: string | symbol): Function[];
        removeAllListeners(eventName?: string | symbol): this;
        removeListener<K>(eventName: string | symbol, listener: ((...args: any[]) => void)): this;
        setMaxListeners(n: number): this;
    }

    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

    • EventEmitter
      • IWorkerNode

    Properties

    Hierarchy

    • EventEmitter
      • IWorkerNode

    Properties

    clearTasksQueue: (() => void)

    Clears tasks queue.

    -
    deleteTaskFunctionWorkerUsage: ((name: string) => boolean)

    Deletes task function worker usage statistics.

    +
    deleteTaskFunctionWorkerUsage: ((name: string) => boolean)

    Deletes task function worker usage statistics.

    Type declaration

      • (name): boolean
      • Parameters

        • name: string

          The task function name.

        Returns boolean

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

        -
    dequeueLastPrioritizedTask: (() => undefined | Task<Data>)

    Dequeue last prioritized task.

    +
    dequeueLastPrioritizedTask: (() => undefined | Task<Data>)

    Dequeue last prioritized task.

    Type declaration

    dequeueTask: ((bucket?: number) => undefined | Task<Data>)

    Dequeue task.

    +
    dequeueTask: ((bucket?: number) => undefined | Task<Data>)

    Dequeue task.

    Type declaration

      • (bucket?): undefined | Task<Data>
      • Parameters

        • Optionalbucket: number

          The prioritized bucket to dequeue from.

        Returns undefined | Task<Data>

        The dequeued task.

    0
     
    -
    enqueueTask: ((task: Task<Data>) => number)

    Enqueue task.

    +
    enqueueTask: ((task: Task<Data>) => number)

    Enqueue task.

    Type declaration

      • (task): number
      • Parameters

        Returns number

        The tasks queue size.

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

    Gets task function worker usage statistics.

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

    Gets task function worker usage statistics.

    Type declaration

      • (name): undefined | WorkerUsage
      • 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.

        -

    Worker info.

    -
    messageChannel?: MessageChannel

    Message channel (worker thread only).

    -
    registerOnceWorkerEventHandler: ((event: string, handler: EventHandler<Worker>) => void)

    Registers once a worker event handler.

    +

    Worker info.

    +
    messageChannel?: MessageChannel

    Message channel (worker thread only).

    +
    registerOnceWorkerEventHandler: ((event: string, handler: EventHandler<Worker>) => void)

    Registers once a worker event handler.

    Type declaration

      • (event, handler): void
      • Parameters

        Returns void

    registerWorkerEventHandler: ((event: string, handler: EventHandler<Worker>) => void)

    Registers a worker event handler.

    +

    Returns void

    registerWorkerEventHandler: ((event: string, handler: EventHandler<Worker>) => void)

    Registers a worker event handler.

    Type declaration

      • (event, handler): void
      • Parameters

        Returns void

    setTasksQueuePriority: ((enablePriority: boolean) => void)

    Sets tasks queue priority.

    +

    Returns void

    setTasksQueuePriority: ((enablePriority: boolean) => void)

    Sets tasks queue priority.

    Type declaration

      • (enablePriority): void
      • Parameters

        • enablePriority: boolean

          Whether to enable tasks queue priority.

          -

        Returns void

    strategyData?: StrategyData

    Worker choice strategy data. +

    Returns void

    strategyData?: StrategyData

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

    -
    tasksQueueBackPressureSize: number

    Tasks queue back pressure size. +

    tasksQueueBackPressureSize: number

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

    -
    tasksQueueSize: (() => number)

    Tasks queue size.

    +
    tasksQueueSize: (() => number)

    Tasks queue size.

    Type declaration

      • (): number
      • Returns number

        The tasks queue size.

        -
    terminate: (() => Promise<void>)

    Terminates the worker node.

    -

    Worker usage statistics.

    -
    worker: Worker

    Worker.

    -

    Methods

    • Type Parameters

      • K

      Parameters

      • error: Error
      • event: string | symbol
      • Rest...args: AnyRest

      Returns void

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

      +
    terminate: (() => Promise<void>)

    Terminates the worker node.

    +

    Worker usage statistics.

    +
    worker: Worker

    Worker.

    +

    Methods

    • Type Parameters

      • K

      Parameters

      • error: Error
      • event: string | symbol
      • Rest...args: AnyRest

      Returns void

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

      Type Parameters

      • K

      Parameters

      • eventName: string | symbol
      • listener: ((...args: any[]) => void)
          • (...args): void
          • Parameters

            • Rest...args: any[]

            Returns void

      Returns this

      v0.1.26

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

      @@ -197,4 +197,4 @@ memory leaks. The emitter.setMaxListeners() method allows the limit modified for this specific EventEmitter instance. The value can be set to Infinity (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 this

      v0.3.5

      -
    +
    diff --git a/docs/interfaces/MeasurementOptions.html b/docs/interfaces/MeasurementOptions.html index 9a9c52fa..bf7a150b 100644 --- a/docs/interfaces/MeasurementOptions.html +++ b/docs/interfaces/MeasurementOptions.html @@ -1,4 +1,4 @@ -MeasurementOptions | poolifier - v4.2.10

    Interface MeasurementOptions

    Measurement options.

    -
    interface MeasurementOptions {
        median: boolean;
    }

    Properties

    median +MeasurementOptions | poolifier - v4.2.11

    Interface MeasurementOptions

    Measurement options.

    +
    interface MeasurementOptions {
        median: boolean;
    }

    Properties

    Properties

    median: boolean

    Set measurement median.

    -
    +
    diff --git a/docs/interfaces/MeasurementStatistics.html b/docs/interfaces/MeasurementStatistics.html index ce9e3db5..9a1df65d 100644 --- a/docs/interfaces/MeasurementStatistics.html +++ b/docs/interfaces/MeasurementStatistics.html @@ -1,14 +1,14 @@ -MeasurementStatistics | poolifier - v4.2.10

    Interface MeasurementStatisticsInternal

    Measurement statistics.

    -
    interface MeasurementStatistics {
        aggregate?: number;
        average?: number;
        history: CircularBuffer;
        maximum?: number;
        median?: number;
        minimum?: number;
    }

    Properties

    aggregate? +MeasurementStatistics | poolifier - v4.2.11

    Interface MeasurementStatisticsInternal

    Measurement statistics.

    +
    interface MeasurementStatistics {
        aggregate?: number;
        average?: number;
        history: CircularBuffer;
        maximum?: number;
        median?: number;
        minimum?: number;
    }

    Properties

    aggregate?: number

    Measurement aggregate.

    -
    average?: number

    Measurement average.

    -

    Measurement history.

    -
    maximum?: number

    Measurement maximum.

    -
    median?: number

    Measurement median.

    -
    minimum?: number

    Measurement minimum.

    -
    +
    average?: number

    Measurement average.

    +

    Measurement history.

    +
    maximum?: number

    Measurement maximum.

    +
    median?: number

    Measurement median.

    +
    minimum?: number

    Measurement minimum.

    +
    diff --git a/docs/interfaces/MeasurementStatisticsRequirements.html b/docs/interfaces/MeasurementStatisticsRequirements.html index cac04841..26becb8c 100644 --- a/docs/interfaces/MeasurementStatisticsRequirements.html +++ b/docs/interfaces/MeasurementStatisticsRequirements.html @@ -1,8 +1,8 @@ -MeasurementStatisticsRequirements | poolifier - v4.2.10

    Interface MeasurementStatisticsRequirementsInternal

    Measurement statistics requirements.

    -
    interface MeasurementStatisticsRequirements {
        aggregate: boolean;
        average: boolean;
        median: boolean;
    }

    Properties

    aggregate +MeasurementStatisticsRequirements | poolifier - v4.2.11

    Interface MeasurementStatisticsRequirementsInternal

    Measurement statistics requirements.

    +
    interface MeasurementStatisticsRequirements {
        aggregate: boolean;
        average: boolean;
        median: boolean;
    }

    Properties

    aggregate: boolean

    Requires measurement aggregate.

    -
    average: boolean

    Requires measurement average.

    -
    median: boolean

    Requires measurement median.

    -
    +
    average: boolean

    Requires measurement average.

    +
    median: boolean

    Requires measurement median.

    +
    diff --git a/docs/interfaces/MessageValue.html b/docs/interfaces/MessageValue.html index e5a826a6..7967706f 100644 --- a/docs/interfaces/MessageValue.html +++ b/docs/interfaces/MessageValue.html @@ -1,7 +1,7 @@ -MessageValue | poolifier - v4.2.10

    Interface MessageValue<Data, ErrorData>Internal

    Message object that is passed between main worker and worker.

    +MessageValue | poolifier - v4.2.11

    Interface MessageValue<Data, ErrorData>Internal

    Message object that is passed between main worker and worker.

    interface MessageValue<Data, ErrorData> {
        checkActive?: boolean;
        data?: Data;
        kill?:
            | true
            | "success"
            | "HARD"
            | "SOFT"
            | "failure";
        name?: string;
        port?: MessagePort;
        priority?: number;
        ready?: boolean;
        statistics?: WorkerStatistics;
        strategy?:
            | "FAIR_SHARE"
            | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
            | "LEAST_BUSY"
            | "LEAST_ELU"
            | "LEAST_USED"
            | "ROUND_ROBIN"
            | "WEIGHTED_ROUND_ROBIN";
        taskFunction?: string;
        taskFunctionOperation?: "add" | "default" | "remove";
        taskFunctionOperationStatus?: boolean;
        taskFunctionProperties?: TaskFunctionProperties;
        taskFunctionsProperties?: TaskFunctionProperties[];
        taskId?: `${string}-${string}-${string}-${string}-${string}`;
        taskPerformance?: TaskPerformance;
        timestamp?: number;
        transferList?: readonly TransferListItem[];
        workerError?: WorkerError<ErrorData>;
        workerId?: number;
    }

    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 (view full)

    Properties

    Hierarchy (view full)

    Properties

    Properties

    checkActive?: boolean

    Whether the worker starts or stops its activity check.

    -
    data?: Data

    Task input data that will be passed to the worker.

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

    Kill code.

    -
    name?: string

    Task name.

    -
    port?: MessagePort

    Message port.

    -
    priority?: number

    Task priority. Lower values have higher priority.

    +
    data?: Data

    Task input data that will be passed to the worker.

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

    Kill code.

    +
    name?: string

    Task name.

    +
    port?: MessagePort

    Message port.

    +
    priority?: number

    Task priority. Lower values have higher priority.

    0
     
    -
    ready?: boolean

    Whether the worker is ready or not.

    -
    statistics?: WorkerStatistics

    Whether the worker computes the given statistics or not.

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

    Task worker choice strategy.

    -
    taskFunction?: string

    Task function serialized to string.

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

    Task function operation:

    +
    ready?: boolean

    Whether the worker is ready or not.

    +
    statistics?: WorkerStatistics

    Whether the worker computes the given statistics or not.

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

    Task worker choice strategy.

    +
    taskFunction?: string

    Task function serialized to string.

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

    Task function operation:

    • 'add' - Add a task function.
    • 'remove' - Remove a task function.
    • 'default' - Set a task function as default.
    -
    taskFunctionOperationStatus?: boolean

    Whether the task function operation is successful or not.

    -
    taskFunctionProperties?: TaskFunctionProperties

    Task function properties.

    -
    taskFunctionsProperties?: TaskFunctionProperties[]

    Task functions properties.

    -
    taskId?: `${string}-${string}-${string}-${string}-${string}`

    Task UUID.

    -
    taskPerformance?: TaskPerformance

    Task performance.

    -
    timestamp?: number

    Timestamp.

    -
    transferList?: readonly TransferListItem[]

    Array of transferable objects.

    -
    workerError?: WorkerError<ErrorData>

    Worker error.

    -
    workerId?: number

    Worker id.

    -
    +
    taskFunctionOperationStatus?: boolean

    Whether the task function operation is successful or not.

    +
    taskFunctionProperties?: TaskFunctionProperties

    Task function properties.

    +
    taskFunctionsProperties?: TaskFunctionProperties[]

    Task functions properties.

    +
    taskId?: `${string}-${string}-${string}-${string}-${string}`

    Task UUID.

    +
    taskPerformance?: TaskPerformance

    Task performance.

    +
    timestamp?: number

    Timestamp.

    +
    transferList?: readonly TransferListItem[]

    Array of transferable objects.

    +
    workerError?: WorkerError<ErrorData>

    Worker error.

    +
    workerId?: number

    Worker id.

    +
    diff --git a/docs/interfaces/PoolInfo.html b/docs/interfaces/PoolInfo.html index 9ad9e333..ae314faf 100644 --- a/docs/interfaces/PoolInfo.html +++ b/docs/interfaces/PoolInfo.html @@ -1,8 +1,9 @@ -PoolInfo | poolifier - v4.2.10

    Interface PoolInfo

    Pool information.

    -
    interface PoolInfo {
        backPressure?: boolean;
        backPressureWorkerNodes?: number;
        busyWorkerNodes: number;
        defaultStrategy:
            | "FAIR_SHARE"
            | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
            | "LEAST_BUSY"
            | "LEAST_ELU"
            | "LEAST_USED"
            | "ROUND_ROBIN"
            | "WEIGHTED_ROUND_ROBIN";
        elu?: {
            active: {
                average?: number;
                maximum: number;
                median?: number;
                minimum: number;
            };
            idle: {
                average?: number;
                maximum: number;
                median?: number;
                minimum: number;
            };
            utilization: {
                average?: number;
                median?: number;
            };
        };
        executedTasks: number;
        executingTasks: number;
        failedTasks: number;
        idleWorkerNodes: number;
        maxQueuedTasks?: number;
        maxSize: number;
        minSize: number;
        queuedTasks?: number;
        ready: boolean;
        runTime?: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        started: boolean;
        stealingWorkerNodes?: number;
        stolenTasks?: number;
        strategyRetries: number;
        type: "fixed" | "dynamic";
        utilization?: number;
        version: string;
        waitTime?: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        worker: "cluster" | "thread";
        workerNodes: number;
    }

    Properties

    backPressure? +PoolInfo | poolifier - v4.2.11

    Interface PoolInfo

    Pool information.

    +
    interface PoolInfo {
        backPressure?: boolean;
        backPressureWorkerNodes?: number;
        busyWorkerNodes: number;
        defaultStrategy:
            | "FAIR_SHARE"
            | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
            | "LEAST_BUSY"
            | "LEAST_ELU"
            | "LEAST_USED"
            | "ROUND_ROBIN"
            | "WEIGHTED_ROUND_ROBIN";
        dynamicWorkerNodes?: number;
        elu?: {
            active: {
                average?: number;
                maximum: number;
                median?: number;
                minimum: number;
            };
            idle: {
                average?: number;
                maximum: number;
                median?: number;
                minimum: number;
            };
            utilization: {
                average?: number;
                median?: number;
            };
        };
        executedTasks: number;
        executingTasks: number;
        failedTasks: number;
        idleWorkerNodes: number;
        maxQueuedTasks?: number;
        maxSize: number;
        minSize: number;
        queuedTasks?: number;
        ready: boolean;
        runTime?: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        started: boolean;
        stealingWorkerNodes?: number;
        stolenTasks?: number;
        strategyRetries: number;
        type: "fixed" | "dynamic";
        utilization?: number;
        version: string;
        waitTime?: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        worker: "cluster" | "thread";
        workerNodes: number;
    }

    Properties

    backPressure?: boolean
    backPressureWorkerNodes?: number

    Pool tasks back pressure worker nodes.

    -
    busyWorkerNodes: number

    Pool busy worker nodes.

    -
    defaultStrategy:
        | "FAIR_SHARE"
        | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
        | "LEAST_BUSY"
        | "LEAST_ELU"
        | "LEAST_USED"
        | "ROUND_ROBIN"
        | "WEIGHTED_ROUND_ROBIN"
    elu?: {
        active: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        idle: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        utilization: {
            average?: number;
            median?: number;
        };
    }
    executedTasks: number
    executingTasks: number
    failedTasks: number
    idleWorkerNodes: number

    Pool idle worker nodes.

    -
    maxQueuedTasks?: number
    maxSize: number
    minSize: number
    queuedTasks?: number
    ready: boolean
    runTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }
    started: boolean
    stealingWorkerNodes?: number

    Pool tasks stealing worker nodes.

    -
    stolenTasks?: number
    strategyRetries: number
    type: "fixed" | "dynamic"
    utilization?: number

    Pool utilization.

    -
    version: string
    waitTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }
    worker: "cluster" | "thread"
    workerNodes: number

    Pool total worker nodes.

    -
    +

    Properties

    backPressure?: boolean
    backPressureWorkerNodes?: number

    Pool tasks back pressure worker nodes.

    +
    busyWorkerNodes: number

    Pool busy worker nodes.

    +
    defaultStrategy:
        | "FAIR_SHARE"
        | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
        | "LEAST_BUSY"
        | "LEAST_ELU"
        | "LEAST_USED"
        | "ROUND_ROBIN"
        | "WEIGHTED_ROUND_ROBIN"
    dynamicWorkerNodes?: number

    Pool dynamic worker nodes.

    +
    elu?: {
        active: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        idle: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        utilization: {
            average?: number;
            median?: number;
        };
    }
    executedTasks: number
    executingTasks: number
    failedTasks: number
    idleWorkerNodes: number

    Pool idle worker nodes.

    +
    maxQueuedTasks?: number
    maxSize: number
    minSize: number
    queuedTasks?: number
    ready: boolean
    runTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }
    started: boolean
    stealingWorkerNodes?: number

    Pool tasks stealing worker nodes.

    +
    stolenTasks?: number
    strategyRetries: number
    type: "fixed" | "dynamic"
    utilization?: number

    Pool utilization.

    +
    version: string
    waitTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }
    worker: "cluster" | "thread"
    workerNodes: number

    Pool total worker nodes.

    +
    diff --git a/docs/interfaces/PoolOptions.html b/docs/interfaces/PoolOptions.html index db92ceb8..b7beb91d 100644 --- a/docs/interfaces/PoolOptions.html +++ b/docs/interfaces/PoolOptions.html @@ -1,6 +1,6 @@ -PoolOptions | poolifier - v4.2.10

    Interface PoolOptions<Worker>

    Options for a poolifier pool.

    +PoolOptions | poolifier - v4.2.11

    Interface PoolOptions<Worker>

    Options for a poolifier pool.

    interface PoolOptions<Worker> {
        enableEvents?: boolean;
        enableTasksQueue?: boolean;
        env?: Record<string, unknown>;
        errorHandler?: ErrorHandler<Worker>;
        exitHandler?: ExitHandler<Worker>;
        messageHandler?: MessageHandler<Worker>;
        onlineHandler?: OnlineHandler<Worker>;
        restartWorkerOnError?: boolean;
        settings?: ClusterSettings;
        startWorkers?: boolean;
        tasksQueueOptions?: TasksQueueOptions;
        workerChoiceStrategy?:
            | "FAIR_SHARE"
            | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
            | "LEAST_BUSY"
            | "LEAST_ELU"
            | "LEAST_USED"
            | "ROUND_ROBIN"
            | "WEIGHTED_ROUND_ROBIN";
        workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions;
        workerOptions?: WorkerOptions;
    }

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -

    Properties

    Properties

    true
     
    -
    enableTasksQueue?: boolean

    Pool worker node tasks queue.

    +
    enableTasksQueue?: boolean

    Pool worker node tasks queue.

    false
     
    -
    env?: Record<string, unknown>

    Key/value pairs to add to worker process environment.

    -
    errorHandler?: ErrorHandler<Worker>

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

    +
    env?: Record<string, unknown>

    Key/value pairs to add to worker process environment.

    +
    errorHandler?: ErrorHandler<Worker>

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

    () => {}

    -
    exitHandler?: ExitHandler<Worker>

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

    +
    exitHandler?: ExitHandler<Worker>

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

    () => {}

    -
    messageHandler?: MessageHandler<Worker>

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

    +
    messageHandler?: MessageHandler<Worker>

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

    () => {}

    -
    onlineHandler?: OnlineHandler<Worker>

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

    +
    onlineHandler?: OnlineHandler<Worker>

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

    () => {}

    -
    restartWorkerOnError?: boolean

    Restart worker on error.

    -
    settings?: ClusterSettings

    Cluster settings.

    -
    startWorkers?: boolean

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

    +
    restartWorkerOnError?: boolean

    Restart worker on error.

    +
    settings?: ClusterSettings

    Cluster settings.

    +
    startWorkers?: boolean

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

    true
     
    -
    tasksQueueOptions?: TasksQueueOptions

    Pool worker node tasks queue options.

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

    The default worker choice strategy to use in this pool.

    +
    tasksQueueOptions?: TasksQueueOptions

    Pool worker node tasks queue options.

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

    The default worker choice strategy to use in this pool.

    WorkerChoiceStrategies.ROUND_ROBIN
     
    -
    workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    -
    workerOptions?: WorkerOptions

    Worker options.

    -
    +
    workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    +
    workerOptions?: WorkerOptions

    Worker options.

    +
    diff --git a/docs/interfaces/PromiseResponseWrapper.html b/docs/interfaces/PromiseResponseWrapper.html index 095a0298..7bb540b4 100644 --- a/docs/interfaces/PromiseResponseWrapper.html +++ b/docs/interfaces/PromiseResponseWrapper.html @@ -1,11 +1,11 @@ -PromiseResponseWrapper | poolifier - v4.2.10

    Interface PromiseResponseWrapper<Response>Internal

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

    +PromiseResponseWrapper | poolifier - v4.2.11

    Interface PromiseResponseWrapper<Response>Internal

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

    interface PromiseResponseWrapper<Response> {
        asyncResource?: AsyncResource;
        reject: ((reason?: unknown) => void);
        resolve: ((value: Response | PromiseLike<Response>) => void);
        workerNodeKey: number;
    }

    Type Parameters

    • Response = unknown

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

      -

    Properties

    Properties

    asyncResource?: AsyncResource

    The asynchronous resource used to track the task execution.

    -
    reject: ((reason?: unknown) => void)

    Reject callback to reject the promise.

    -
    resolve: ((value: Response | PromiseLike<Response>) => void)

    Resolve callback to fulfill the promise.

    -
    workerNodeKey: number

    The worker node key executing the task.

    -
    +
    reject: ((reason?: unknown) => void)

    Reject callback to reject the promise.

    +
    resolve: ((value: Response | PromiseLike<Response>) => void)

    Resolve callback to fulfill the promise.

    +
    workerNodeKey: number

    The worker node key executing the task.

    +
    diff --git a/docs/interfaces/StrategyData.html b/docs/interfaces/StrategyData.html index 67be4a82..334126c0 100644 --- a/docs/interfaces/StrategyData.html +++ b/docs/interfaces/StrategyData.html @@ -1,3 +1,3 @@ -StrategyData | poolifier - v4.2.10

    Interface StrategyDataInternal

    Worker choice strategy data.

    -
    interface StrategyData {
        virtualTaskEndTimestamp?: number;
    }

    Properties

    virtualTaskEndTimestamp?: number
    +StrategyData | poolifier - v4.2.11

    Interface StrategyDataInternal

    Worker choice strategy data.

    +
    interface StrategyData {
        virtualTaskEndTimestamp?: number;
    }

    Properties

    virtualTaskEndTimestamp?: number
    diff --git a/docs/interfaces/StrategyPolicy.html b/docs/interfaces/StrategyPolicy.html index 2207f0bd..52882c42 100644 --- a/docs/interfaces/StrategyPolicy.html +++ b/docs/interfaces/StrategyPolicy.html @@ -1,6 +1,6 @@ -StrategyPolicy | poolifier - v4.2.10

    Interface StrategyPolicyInternal

    Strategy policy.

    -
    interface StrategyPolicy {
        dynamicWorkerReady: boolean;
        dynamicWorkerUsage: boolean;
    }

    Properties

    dynamicWorkerReady +StrategyPolicy | poolifier - v4.2.11

    Interface StrategyPolicyInternal

    Strategy policy.

    +
    interface StrategyPolicy {
        dynamicWorkerReady: boolean;
        dynamicWorkerUsage: boolean;
    }

    Properties

    dynamicWorkerReady: boolean

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

    -
    dynamicWorkerUsage: boolean

    Expects tasks execution on the newly created dynamic worker.

    -
    +
    dynamicWorkerUsage: boolean

    Expects tasks execution on the newly created dynamic worker.

    +
    diff --git a/docs/interfaces/Task.html b/docs/interfaces/Task.html index 85eabe15..ffb5ac9e 100644 --- a/docs/interfaces/Task.html +++ b/docs/interfaces/Task.html @@ -1,6 +1,6 @@ -Task | poolifier - v4.2.10

    Interface Task<Data>Internal

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

    +Task | poolifier - v4.2.11

    Interface Task<Data>Internal

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

    interface Task<Data> {
        data?: Data;
        name?: string;
        priority?: number;
        strategy?:
            | "FAIR_SHARE"
            | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
            | "LEAST_BUSY"
            | "LEAST_ELU"
            | "LEAST_USED"
            | "ROUND_ROBIN"
            | "WEIGHTED_ROUND_ROBIN";
        taskId?: `${string}-${string}-${string}-${string}-${string}`;
        timestamp?: number;
        transferList?: readonly TransferListItem[];
    }

    Type Parameters

    • Data = unknown

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

      -

    Hierarchy (view full)

    Properties

    Hierarchy (view full)

    Properties

    Properties

    data?: Data

    Task input data that will be passed to the worker.

    -
    name?: string

    Task name.

    -
    priority?: number

    Task priority. Lower values have higher priority.

    +
    name?: string

    Task name.

    +
    priority?: number

    Task priority. Lower values have higher priority.

    0
     
    -
    strategy?:
        | "FAIR_SHARE"
        | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
        | "LEAST_BUSY"
        | "LEAST_ELU"
        | "LEAST_USED"
        | "ROUND_ROBIN"
        | "WEIGHTED_ROUND_ROBIN"

    Task worker choice strategy.

    -
    taskId?: `${string}-${string}-${string}-${string}-${string}`

    Task UUID.

    -
    timestamp?: number

    Timestamp.

    -
    transferList?: readonly TransferListItem[]

    Array of transferable objects.

    -
    +
    strategy?:
        | "FAIR_SHARE"
        | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
        | "LEAST_BUSY"
        | "LEAST_ELU"
        | "LEAST_USED"
        | "ROUND_ROBIN"
        | "WEIGHTED_ROUND_ROBIN"

    Task worker choice strategy.

    +
    taskId?: `${string}-${string}-${string}-${string}-${string}`

    Task UUID.

    +
    timestamp?: number

    Timestamp.

    +
    transferList?: readonly TransferListItem[]

    Array of transferable objects.

    +
    diff --git a/docs/interfaces/TaskFunctionObject.html b/docs/interfaces/TaskFunctionObject.html index 3310b5ef..41923e93 100644 --- a/docs/interfaces/TaskFunctionObject.html +++ b/docs/interfaces/TaskFunctionObject.html @@ -1,10 +1,10 @@ -TaskFunctionObject | poolifier - v4.2.10

    Interface TaskFunctionObject<Data, Response>

    Task function object.

    +TaskFunctionObject | poolifier - v4.2.11

    Interface TaskFunctionObject<Data, Response>

    Task function object.

    interface TaskFunctionObject<Data, Response> {
        priority?: number;
        strategy?:
            | "FAIR_SHARE"
            | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
            | "LEAST_BUSY"
            | "LEAST_ELU"
            | "LEAST_USED"
            | "ROUND_ROBIN"
            | "WEIGHTED_ROUND_ROBIN";
        taskFunction: TaskFunction<Data, Response>;
    }

    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.

      -

    Properties

    Properties

    priority?: number

    Task function priority. Lower values have higher priority.

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

    Task function worker choice strategy.

    -
    taskFunction: TaskFunction<Data, Response>

    Task function.

    -
    +
    strategy?:
        | "FAIR_SHARE"
        | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
        | "LEAST_BUSY"
        | "LEAST_ELU"
        | "LEAST_USED"
        | "ROUND_ROBIN"
        | "WEIGHTED_ROUND_ROBIN"

    Task function worker choice strategy.

    +
    taskFunction: TaskFunction<Data, Response>

    Task function.

    +
    diff --git a/docs/interfaces/TaskFunctionOperationResult.html b/docs/interfaces/TaskFunctionOperationResult.html index bd30772f..5a64717b 100644 --- a/docs/interfaces/TaskFunctionOperationResult.html +++ b/docs/interfaces/TaskFunctionOperationResult.html @@ -1,4 +1,4 @@ -TaskFunctionOperationResult | poolifier - v4.2.10

    Interface TaskFunctionOperationResult

    Task function operation result.

    -
    interface TaskFunctionOperationResult {
        error?: Error;
        status: boolean;
    }

    Properties

    error? +TaskFunctionOperationResult | poolifier - v4.2.11

    Interface TaskFunctionOperationResult

    Task function operation result.

    +
    interface TaskFunctionOperationResult {
        error?: Error;
        status: boolean;
    }

    Properties

    Properties

    error?: Error
    status: boolean
    +

    Properties

    error?: Error
    status: boolean
    diff --git a/docs/interfaces/TaskFunctionProperties.html b/docs/interfaces/TaskFunctionProperties.html index cd1fc0ac..91a271b9 100644 --- a/docs/interfaces/TaskFunctionProperties.html +++ b/docs/interfaces/TaskFunctionProperties.html @@ -1,8 +1,8 @@ -TaskFunctionProperties | poolifier - v4.2.10

    Interface TaskFunctionProperties

    Task function properties.

    -
    interface TaskFunctionProperties {
        name: string;
        priority?: number;
        strategy?:
            | "FAIR_SHARE"
            | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
            | "LEAST_BUSY"
            | "LEAST_ELU"
            | "LEAST_USED"
            | "ROUND_ROBIN"
            | "WEIGHTED_ROUND_ROBIN";
    }

    Properties

    name +TaskFunctionProperties | poolifier - v4.2.11

    Interface TaskFunctionProperties

    Task function properties.

    +
    interface TaskFunctionProperties {
        name: string;
        priority?: number;
        strategy?:
            | "FAIR_SHARE"
            | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
            | "LEAST_BUSY"
            | "LEAST_ELU"
            | "LEAST_USED"
            | "ROUND_ROBIN"
            | "WEIGHTED_ROUND_ROBIN";
    }

    Properties

    name: string

    Task function name.

    -
    priority?: number

    Task function priority. Lower values have higher priority.

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

    Task function worker choice strategy.

    -
    +
    priority?: number

    Task function priority. Lower values have higher priority.

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

    Task function worker choice strategy.

    +
    diff --git a/docs/interfaces/TaskPerformance.html b/docs/interfaces/TaskPerformance.html index d4f7d70a..b3d0c39c 100644 --- a/docs/interfaces/TaskPerformance.html +++ b/docs/interfaces/TaskPerformance.html @@ -1,10 +1,10 @@ -TaskPerformance | poolifier - v4.2.10

    Interface TaskPerformanceInternal

    Task performance.

    -
    interface TaskPerformance {
        elu?: EventLoopUtilization;
        name: string;
        runTime?: number;
        timestamp: number;
    }

    Properties

    elu? +TaskPerformance | poolifier - v4.2.11

    Interface TaskPerformanceInternal

    Task performance.

    +
    interface TaskPerformance {
        elu?: EventLoopUtilization;
        name: string;
        runTime?: number;
        timestamp: number;
    }

    Properties

    elu?: EventLoopUtilization

    Task event loop utilization.

    -
    name: string

    Task name.

    -
    runTime?: number

    Task runtime.

    -
    timestamp: number

    Task performance timestamp.

    -
    +
    name: string

    Task name.

    +
    runTime?: number

    Task runtime.

    +
    timestamp: number

    Task performance timestamp.

    +
    diff --git a/docs/interfaces/TaskStatistics.html b/docs/interfaces/TaskStatistics.html index bcc63b8d..65987786 100644 --- a/docs/interfaces/TaskStatistics.html +++ b/docs/interfaces/TaskStatistics.html @@ -1,5 +1,5 @@ -TaskStatistics | poolifier - v4.2.10

    Interface TaskStatisticsInternal

    Task statistics.

    -
    interface TaskStatistics {
        executed: number;
        executing: number;
        failed: number;
        maxQueued?: number;
        queued: number;
        sequentiallyStolen: number;
        stolen: number;
    }

    Properties

    executed +TaskStatistics | poolifier - v4.2.11

    Interface TaskStatisticsInternal

    Task statistics.

    +
    interface TaskStatistics {
        executed: number;
        executing: number;
        failed: number;
        maxQueued?: number;
        queued: number;
        sequentiallyStolen: number;
        stolen: number;
    }

    Properties

    executed: number

    Number of executed tasks.

    -
    executing: number

    Number of executing tasks.

    -
    failed: number

    Number of failed tasks.

    -
    maxQueued?: number

    Maximum number of queued tasks.

    -
    queued: number

    Number of queued tasks.

    -
    sequentiallyStolen: number

    Number of sequentially stolen tasks.

    -
    stolen: number

    Number of stolen tasks.

    -
    +
    executing: number

    Number of executing tasks.

    +
    failed: number

    Number of failed tasks.

    +
    maxQueued?: number

    Maximum number of queued tasks.

    +
    queued: number

    Number of queued tasks.

    +
    sequentiallyStolen: number

    Number of sequentially stolen tasks.

    +
    stolen: number

    Number of stolen tasks.

    +
    diff --git a/docs/interfaces/TaskStatisticsRequirements.html b/docs/interfaces/TaskStatisticsRequirements.html index 3c676960..838aba7e 100644 --- a/docs/interfaces/TaskStatisticsRequirements.html +++ b/docs/interfaces/TaskStatisticsRequirements.html @@ -1,8 +1,8 @@ -TaskStatisticsRequirements | poolifier - v4.2.10

    Interface TaskStatisticsRequirementsInternal

    Pool worker node worker usage statistics requirements.

    -
    interface TaskStatisticsRequirements {
        elu: MeasurementStatisticsRequirements;
        runTime: MeasurementStatisticsRequirements;
        waitTime: MeasurementStatisticsRequirements;
    }

    Properties

    elu +TaskStatisticsRequirements | poolifier - v4.2.11

    Interface TaskStatisticsRequirementsInternal

    Pool worker node worker usage statistics requirements.

    +
    interface TaskStatisticsRequirements {
        elu: MeasurementStatisticsRequirements;
        runTime: MeasurementStatisticsRequirements;
        waitTime: MeasurementStatisticsRequirements;
    }

    Properties

    Properties

    Tasks event loop utilization requirements.

    -

    Tasks runtime requirements.

    -

    Tasks wait time requirements.

    -
    +

    Tasks runtime requirements.

    +

    Tasks wait time requirements.

    +
    diff --git a/docs/interfaces/TasksQueueOptions.html b/docs/interfaces/TasksQueueOptions.html index e8c6320a..1e22b763 100644 --- a/docs/interfaces/TasksQueueOptions.html +++ b/docs/interfaces/TasksQueueOptions.html @@ -1,32 +1,32 @@ -TasksQueueOptions | poolifier - v4.2.10

    Interface TasksQueueOptions

    Worker node tasks queue options.

    -
    interface TasksQueueOptions {
        concurrency?: number;
        size?: number;
        taskStealing?: boolean;
        tasksFinishedTimeout?: number;
        tasksStealingOnBackPressure?: boolean;
        tasksStealingRatio?: number;
    }

    Properties

    concurrency? +TasksQueueOptions | poolifier - v4.2.11

    Interface TasksQueueOptions

    Worker node tasks queue options.

    +
    interface TasksQueueOptions {
        concurrency?: number;
        size?: number;
        tasksFinishedTimeout?: number;
        tasksStealingOnBackPressure?: boolean;
        tasksStealingRatio?: number;
        taskStealing?: boolean;
    }

    Properties

    concurrency?: number

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

    1
     
    -
    size?: number

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

    +
    size?: number

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

    (pool maximum size)^2
     
    -
    taskStealing?: boolean

    Whether to enable task stealing on idle.

    -
    true
    +
    tasksFinishedTimeout?: number

    Queued tasks finished timeout in milliseconds at worker node termination.

    +
    2000
     
    -
    tasksFinishedTimeout?: number

    Queued tasks finished timeout in milliseconds at worker node termination.

    -
    2000
    +
    tasksStealingOnBackPressure?: boolean

    Whether to enable tasks stealing under back pressure.

    +
    true
     
    -
    tasksStealingOnBackPressure?: boolean

    Whether to enable tasks stealing under back pressure.

    -
    true
    +
    tasksStealingRatio?: number

    Ratio of worker nodes that can steal tasks from another worker node.

    +
    0.6
     
    -
    tasksStealingRatio?: number

    Ratio of worker nodes that can steal tasks from another worker node.

    -
    0.6
    +
    taskStealing?: boolean

    Whether to enable task stealing on idle.

    +
    true
     
    -
    +
    diff --git a/docs/interfaces/WorkerChoiceStrategyOptions.html b/docs/interfaces/WorkerChoiceStrategyOptions.html index d2ed90f6..d6df38a0 100644 --- a/docs/interfaces/WorkerChoiceStrategyOptions.html +++ b/docs/interfaces/WorkerChoiceStrategyOptions.html @@ -1,5 +1,5 @@ -WorkerChoiceStrategyOptions | poolifier - v4.2.10

    Interface WorkerChoiceStrategyOptions

    Worker choice strategy options.

    -
    interface WorkerChoiceStrategyOptions {
        elu?: MeasurementOptions;
        measurement?: "elu" | "runTime" | "waitTime";
        runTime?: MeasurementOptions;
        waitTime?: MeasurementOptions;
        weights?: Record<number, number>;
    }

    Properties

    elu? +WorkerChoiceStrategyOptions | poolifier - v4.2.11

    Interface WorkerChoiceStrategyOptions

    Worker choice strategy options.

    +
    interface WorkerChoiceStrategyOptions {
        elu?: MeasurementOptions;
        measurement?: "elu" | "runTime" | "waitTime";
        runTime?: MeasurementOptions;
        waitTime?: MeasurementOptions;
        weights?: Record<number, number>;
    }

    Properties

    elu? measurement? runTime? waitTime? @@ -8,18 +8,18 @@
    { median: false }
     
    -
    measurement?: "elu" | "runTime" | "waitTime"

    Measurement to use in worker choice strategy supporting it.

    -

    Runtime options.

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

    Measurement to use in worker choice strategy supporting it.

    +

    Runtime options.

    { median: false }
     
    -

    Wait time options.

    +

    Wait time options.

    { median: false }
     
    -
    weights?: Record<number, number>

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

    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.

    Weights computed automatically given the CPU performance.
     
    -
    +
    diff --git a/docs/interfaces/WorkerError.html b/docs/interfaces/WorkerError.html index fdf8e296..94b1319f 100644 --- a/docs/interfaces/WorkerError.html +++ b/docs/interfaces/WorkerError.html @@ -1,9 +1,9 @@ -WorkerError | poolifier - v4.2.10

    Interface WorkerError<Data>

    Worker error.

    +WorkerError | poolifier - v4.2.11

    Interface WorkerError<Data>

    Worker error.

    interface WorkerError<Data> {
        data?: Data;
        message: string;
        name: string;
    }

    Type Parameters

    • Data = unknown

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

      -

    Properties

    Properties

    Properties

    data?: Data

    Data triggering the error.

    -
    message: string

    Error message.

    -
    name: string

    Task function name triggering the error.

    -
    +
    message: string

    Error message.

    +
    name: string

    Task function name triggering the error.

    +
    diff --git a/docs/interfaces/WorkerInfo.html b/docs/interfaces/WorkerInfo.html index 7ee8259a..1e2168e6 100644 --- a/docs/interfaces/WorkerInfo.html +++ b/docs/interfaces/WorkerInfo.html @@ -1,5 +1,5 @@ -WorkerInfo | poolifier - v4.2.10

    Interface WorkerInfoInternal

    Worker information.

    -
    interface WorkerInfo {
        backPressure: boolean;
        backPressureStealing: boolean;
        continuousStealing: boolean;
        dynamic: boolean;
        id: undefined | number;
        ready: boolean;
        stealing: boolean;
        stolen: boolean;
        taskFunctionsProperties?: TaskFunctionProperties[];
        type: "cluster" | "thread";
    }

    Properties

    backPressure +WorkerInfo | poolifier - v4.2.11

    Interface WorkerInfoInternal

    Worker information.

    +
    interface WorkerInfo {
        backPressure: boolean;
        backPressureStealing: boolean;
        continuousStealing: boolean;
        dynamic: boolean;
        id: undefined | number;
        ready: boolean;
        stealing: boolean;
        stolen: boolean;
        taskFunctionsProperties?: TaskFunctionProperties[];
        type: "cluster" | "thread";
    }

    Properties

    backPressure: boolean

    Back pressure flag. This flag is set to true when worker node tasks queue is back pressured.

    -
    backPressureStealing: boolean

    Back pressure stealing flag. +

    backPressureStealing: boolean

    Back pressure stealing flag. This flag is set to true when worker node is stealing one task from another back pressured worker node.

    -
    continuousStealing: boolean

    Continuous stealing flag. +

    continuousStealing: boolean

    Continuous stealing flag. This flag is set to true when worker node is continuously stealing tasks from other worker nodes.

    -
    dynamic: boolean

    Dynamic flag.

    -
    id: undefined | number

    Worker id.

    -
    ready: boolean

    Ready flag.

    -
    stealing: boolean

    Stealing flag. +

    dynamic: boolean

    Dynamic flag.

    +
    id: undefined | number

    Worker id.

    +
    ready: boolean

    Ready flag.

    +
    stealing: boolean

    Stealing flag. This flag is set to true when worker node is stealing one task from another worker node.

    -
    stolen: boolean

    Stolen flag. +

    stolen: boolean

    Stolen flag. This flag is set to true when worker node has one task stolen from another worker node.

    -
    taskFunctionsProperties?: TaskFunctionProperties[]

    Task functions properties.

    -
    type: "cluster" | "thread"

    Worker type.

    -
    +
    taskFunctionsProperties?: TaskFunctionProperties[]

    Task functions properties.

    +
    type: "cluster" | "thread"

    Worker type.

    +
    diff --git a/docs/interfaces/WorkerNodeEventDetail.html b/docs/interfaces/WorkerNodeEventDetail.html index 2d3981ee..7fca7231 100644 --- a/docs/interfaces/WorkerNodeEventDetail.html +++ b/docs/interfaces/WorkerNodeEventDetail.html @@ -1,4 +1,4 @@ -WorkerNodeEventDetail | poolifier - v4.2.10

    Interface WorkerNodeEventDetailInternal

    Worker node event detail.

    -
    interface WorkerNodeEventDetail {
        workerId?: number;
        workerNodeKey?: number;
    }

    Properties

    workerId? +WorkerNodeEventDetail | poolifier - v4.2.11

    Interface WorkerNodeEventDetailInternal

    Worker node event detail.

    +
    interface WorkerNodeEventDetail {
        workerId?: number;
        workerNodeKey?: number;
    }

    Properties

    workerId?: number
    workerNodeKey?: number
    +

    Properties

    workerId?: number
    workerNodeKey?: number
    diff --git a/docs/interfaces/WorkerNodeOptions.html b/docs/interfaces/WorkerNodeOptions.html index 426d5c6a..368422a4 100644 --- a/docs/interfaces/WorkerNodeOptions.html +++ b/docs/interfaces/WorkerNodeOptions.html @@ -1,7 +1,7 @@ -WorkerNodeOptions | poolifier - v4.2.10

    Interface WorkerNodeOptionsInternal

    Worker node options.

    -
    interface WorkerNodeOptions {
        env?: Record<string, unknown>;
        tasksQueueBackPressureSize: undefined | number;
        tasksQueueBucketSize: undefined | number;
        tasksQueuePriority: undefined | boolean;
        workerOptions?: WorkerOptions;
    }

    Properties

    env? +WorkerNodeOptions | poolifier - v4.2.11

    Interface WorkerNodeOptionsInternal

    Worker node options.

    +
    interface WorkerNodeOptions {
        env?: Record<string, unknown>;
        tasksQueueBackPressureSize: undefined | number;
        tasksQueueBucketSize: undefined | number;
        tasksQueuePriority: undefined | boolean;
        workerOptions?: WorkerOptions;
    }

    Properties

    env?: Record<string, unknown>
    tasksQueueBackPressureSize: undefined | number
    tasksQueueBucketSize: undefined | number
    tasksQueuePriority: undefined | boolean
    workerOptions?: WorkerOptions
    +

    Properties

    env?: Record<string, unknown>
    tasksQueueBackPressureSize: undefined | number
    tasksQueueBucketSize: undefined | number
    tasksQueuePriority: undefined | boolean
    workerOptions?: WorkerOptions
    diff --git a/docs/interfaces/WorkerOptions.html b/docs/interfaces/WorkerOptions.html index 9e6b489b..862dca9f 100644 --- a/docs/interfaces/WorkerOptions.html +++ b/docs/interfaces/WorkerOptions.html @@ -1,5 +1,5 @@ -WorkerOptions | poolifier - v4.2.10

    Interface WorkerOptions

    Options for workers.

    -
    interface WorkerOptions {
        killBehavior?: "HARD" | "SOFT";
        killHandler?: KillHandler;
        maxInactiveTime?: number;
    }

    Properties

    killBehavior? +WorkerOptions | poolifier - v4.2.11

    Interface WorkerOptions

    Options for workers.

    +
    interface WorkerOptions {
        killBehavior?: "HARD" | "SOFT";
        killHandler?: KillHandler;
        maxInactiveTime?: number;
    }

    Properties

    killBehavior?: "HARD" | "SOFT"

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

    @@ -11,9 +11,9 @@
    KillBehaviors.SOFT
     
    -
    killHandler?: KillHandler

    The function to call when a worker is killed.

    +
    killHandler?: KillHandler

    The function to call when a worker is killed.

    () => {}

    -
    maxInactiveTime?: number

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

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

      @@ -24,4 +24,4 @@ when this timeout expires your tasks is interrupted before completion and remove
    60000
     
    -
    +
    diff --git a/docs/interfaces/WorkerStatistics.html b/docs/interfaces/WorkerStatistics.html index d743b722..795e7cd5 100644 --- a/docs/interfaces/WorkerStatistics.html +++ b/docs/interfaces/WorkerStatistics.html @@ -1,6 +1,6 @@ -WorkerStatistics | poolifier - v4.2.10

    Interface WorkerStatisticsInternal

    Worker task performance statistics computation settings.

    -
    interface WorkerStatistics {
        elu: boolean;
        runTime: boolean;
    }

    Properties

    elu +WorkerStatistics | poolifier - v4.2.11

    Interface WorkerStatisticsInternal

    Worker task performance statistics computation settings.

    +
    interface WorkerStatistics {
        elu: boolean;
        runTime: boolean;
    }

    Properties

    Properties

    elu: boolean

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

    -
    runTime: boolean

    Whether the worker computes the task runtime or not.

    -
    +
    runTime: boolean

    Whether the worker computes the task runtime or not.

    +
    diff --git a/docs/interfaces/WorkerUsage.html b/docs/interfaces/WorkerUsage.html index fe4b6f60..14d8dfaa 100644 --- a/docs/interfaces/WorkerUsage.html +++ b/docs/interfaces/WorkerUsage.html @@ -1,10 +1,10 @@ -WorkerUsage | poolifier - v4.2.10

    Interface WorkerUsageInternal

    Worker usage statistics.

    -
    interface WorkerUsage {
        elu: EventLoopUtilizationMeasurementStatistics;
        runTime: MeasurementStatistics;
        tasks: TaskStatistics;
        waitTime: MeasurementStatistics;
    }

    Properties

    elu +WorkerUsage | poolifier - v4.2.11

    Interface WorkerUsageInternal

    Worker usage statistics.

    +
    interface WorkerUsage {
        elu: EventLoopUtilizationMeasurementStatistics;
        runTime: MeasurementStatistics;
        tasks: TaskStatistics;
        waitTime: MeasurementStatistics;
    }

    Properties

    Tasks event loop utilization statistics.

    -

    Tasks runtime statistics.

    -

    Tasks statistics.

    -

    Tasks wait time statistics.

    -
    +

    Tasks runtime statistics.

    +

    Tasks statistics.

    +

    Tasks wait time statistics.

    +
    diff --git a/docs/types/ClusterPoolOptions.html b/docs/types/ClusterPoolOptions.html index a6c9b305..a4c5d103 100644 --- a/docs/types/ClusterPoolOptions.html +++ b/docs/types/ClusterPoolOptions.html @@ -1,2 +1,2 @@ -ClusterPoolOptions | poolifier - v4.2.10

    Type Alias ClusterPoolOptions

    ClusterPoolOptions: PoolOptions<Worker>

    Options for a poolifier cluster pool.

    -
    +ClusterPoolOptions | poolifier - v4.2.11

    Type Alias ClusterPoolOptions

    ClusterPoolOptions: PoolOptions<Worker>

    Options for a poolifier cluster pool.

    +
    diff --git a/docs/types/ErrorHandler.html b/docs/types/ErrorHandler.html index 35cb9b89..3a99474e 100644 --- a/docs/types/ErrorHandler.html +++ b/docs/types/ErrorHandler.html @@ -1,3 +1,3 @@ -ErrorHandler | poolifier - v4.2.10

    Type Alias ErrorHandler<Worker>

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

    Callback invoked if the worker raised an error.

    +ErrorHandler | poolifier - v4.2.11

    Type Alias ErrorHandler<Worker>

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

    Callback invoked if the worker raised an error.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -
    +
    diff --git a/docs/types/EventHandler.html b/docs/types/EventHandler.html index 3d964e8d..78152f03 100644 --- a/docs/types/EventHandler.html +++ b/docs/types/EventHandler.html @@ -1,3 +1,3 @@ -EventHandler | poolifier - v4.2.10

    Type Alias EventHandler<Worker>

    EventHandler<Worker>:
        | ErrorHandler<Worker>
        | ExitHandler<Worker>
        | MessageHandler<Worker>
        | OnlineHandler<Worker>

    Worker event handler.

    +EventHandler | poolifier - v4.2.11

    Type Alias EventHandler<Worker>

    EventHandler<Worker>:
        | ErrorHandler<Worker>
        | ExitHandler<Worker>
        | MessageHandler<Worker>
        | OnlineHandler<Worker>

    Worker event handler.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -
    +
    diff --git a/docs/types/ExitHandler.html b/docs/types/ExitHandler.html index 6f974a3f..b05a9530 100644 --- a/docs/types/ExitHandler.html +++ b/docs/types/ExitHandler.html @@ -1,3 +1,3 @@ -ExitHandler | poolifier - v4.2.10

    Type Alias ExitHandler<Worker>

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

    Callback invoked when the worker exits successfully.

    +ExitHandler | poolifier - v4.2.11

    Type Alias ExitHandler<Worker>

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

    Callback invoked when the worker exits successfully.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -
    +
    diff --git a/docs/types/KillBehavior.html b/docs/types/KillBehavior.html index e706f80d..2d28a677 100644 --- a/docs/types/KillBehavior.html +++ b/docs/types/KillBehavior.html @@ -1,2 +1,2 @@ -KillBehavior | poolifier - v4.2.10

    Type Alias KillBehavior

    KillBehavior: keyof typeof KillBehaviors

    Kill behavior.

    -
    +KillBehavior | poolifier - v4.2.11

    Type Alias KillBehavior

    KillBehavior: keyof typeof KillBehaviors

    Kill behavior.

    +
    diff --git a/docs/types/KillHandler.html b/docs/types/KillHandler.html index 5318cb9a..0379a122 100644 --- a/docs/types/KillHandler.html +++ b/docs/types/KillHandler.html @@ -1,2 +1,2 @@ -KillHandler | poolifier - v4.2.10

    Type Alias KillHandler

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

    Handler called when a worker is killed.

    -
    +KillHandler | poolifier - v4.2.11

    Type Alias KillHandler

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

    Handler called when a worker is killed.

    +
    diff --git a/docs/types/Measurement.html b/docs/types/Measurement.html index 91d13f03..dda9f652 100644 --- a/docs/types/Measurement.html +++ b/docs/types/Measurement.html @@ -1,2 +1,2 @@ -Measurement | poolifier - v4.2.10

    Type Alias Measurement

    Measurement: keyof typeof Measurements

    Measurement.

    -
    +Measurement | poolifier - v4.2.11

    Type Alias Measurement

    Measurement: keyof typeof Measurements

    Measurement.

    +
    diff --git a/docs/types/MessageHandler.html b/docs/types/MessageHandler.html index c345f057..799fdb41 100644 --- a/docs/types/MessageHandler.html +++ b/docs/types/MessageHandler.html @@ -1,3 +1,3 @@ -MessageHandler | poolifier - v4.2.10

    Type Alias MessageHandler<Worker>

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

    Callback invoked if the worker has received a message.

    +MessageHandler | poolifier - v4.2.11

    Type Alias MessageHandler<Worker>

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

    Callback invoked if the worker has received a message.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -
    +
    diff --git a/docs/types/OnlineHandler.html b/docs/types/OnlineHandler.html index b5c70d44..ca920b6f 100644 --- a/docs/types/OnlineHandler.html +++ b/docs/types/OnlineHandler.html @@ -1,3 +1,3 @@ -OnlineHandler | poolifier - v4.2.10

    Type Alias OnlineHandler<Worker>

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

    Callback invoked when the worker has started successfully.

    +OnlineHandler | poolifier - v4.2.11

    Type Alias OnlineHandler<Worker>

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

    Callback invoked when the worker has started successfully.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -
    +
    diff --git a/docs/types/PoolEvent.html b/docs/types/PoolEvent.html index d4375c3e..7bc440c0 100644 --- a/docs/types/PoolEvent.html +++ b/docs/types/PoolEvent.html @@ -1,2 +1,2 @@ -PoolEvent | poolifier - v4.2.10

    Type Alias PoolEvent

    PoolEvent: keyof typeof PoolEvents

    Pool event.

    -
    +PoolEvent | poolifier - v4.2.11

    Type Alias PoolEvent

    PoolEvent: keyof typeof PoolEvents

    Pool event.

    +
    diff --git a/docs/types/PoolType.html b/docs/types/PoolType.html index b4e5afc1..a9708759 100644 --- a/docs/types/PoolType.html +++ b/docs/types/PoolType.html @@ -1,2 +1,2 @@ -PoolType | poolifier - v4.2.10

    Type Alias PoolType

    PoolType: keyof typeof PoolTypes

    Pool type.

    -
    +PoolType | poolifier - v4.2.11

    Type Alias PoolType

    PoolType: keyof typeof PoolTypes

    Pool type.

    +
    diff --git a/docs/types/TaskAsyncFunction.html b/docs/types/TaskAsyncFunction.html index 36869597..2f344381 100644 --- a/docs/types/TaskAsyncFunction.html +++ b/docs/types/TaskAsyncFunction.html @@ -1,7 +1,7 @@ -TaskAsyncFunction | poolifier - v4.2.10

    Type Alias TaskAsyncFunction<Data, Response>

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

    Task asynchronous function that can be executed. +TaskAsyncFunction | poolifier - v4.2.11

    Type Alias TaskAsyncFunction<Data, Response>

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

    Task asynchronous function that can be executed. This function must return a promise.

    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.

    Type declaration

      • (data?): Promise<Response>
      • Parameters

        • Optionaldata: Data

          Data sent to the worker.

        Returns Promise<Response>

        Execution response promise.

        -
    +
    diff --git a/docs/types/TaskFunction.html b/docs/types/TaskFunction.html index d24c95b6..fe99822a 100644 --- a/docs/types/TaskFunction.html +++ b/docs/types/TaskFunction.html @@ -1,5 +1,5 @@ -TaskFunction | poolifier - v4.2.10

    Type Alias TaskFunction<Data, Response>

    Task function that can be executed. +TaskFunction | poolifier - v4.2.11

    Type Alias TaskFunction<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.

      -
    +
    diff --git a/docs/types/TaskFunctions.html b/docs/types/TaskFunctions.html index cf636450..0f4a7261 100644 --- a/docs/types/TaskFunctions.html +++ b/docs/types/TaskFunctions.html @@ -1,6 +1,6 @@ -TaskFunctions | poolifier - v4.2.10

    Type Alias TaskFunctions<Data, Response>

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

    Tasks functions that can be executed. +TaskFunctions | poolifier - v4.2.11

    Type Alias TaskFunctions<Data, Response>

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

    Tasks functions that can be executed. The key is the name of the task function or task function object. The value is the task function or task function object.

    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.

      -
    +
    diff --git a/docs/types/TaskSyncFunction.html b/docs/types/TaskSyncFunction.html index 356132f8..bf8045d6 100644 --- a/docs/types/TaskSyncFunction.html +++ b/docs/types/TaskSyncFunction.html @@ -1,6 +1,6 @@ -TaskSyncFunction | poolifier - v4.2.10

    Type Alias TaskSyncFunction<Data, Response>

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

    Task synchronous function that can be executed.

    +TaskSyncFunction | poolifier - v4.2.11

    Type Alias TaskSyncFunction<Data, Response>

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

    Task synchronous function that can be executed.

    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.

    Type declaration

      • (data?): Response
      • Parameters

        • Optionaldata: Data

          Data sent to the worker.

        Returns Response

        Execution response.

        -
    +
    diff --git a/docs/types/ThreadPoolOptions.html b/docs/types/ThreadPoolOptions.html index ffa1adb6..8831f581 100644 --- a/docs/types/ThreadPoolOptions.html +++ b/docs/types/ThreadPoolOptions.html @@ -1,2 +1,2 @@ -ThreadPoolOptions | poolifier - v4.2.10

    Type Alias ThreadPoolOptions

    ThreadPoolOptions: PoolOptions<Worker>

    Options for a poolifier thread pool.

    -
    +ThreadPoolOptions | poolifier - v4.2.11

    Type Alias ThreadPoolOptions

    ThreadPoolOptions: PoolOptions<Worker>

    Options for a poolifier thread pool.

    +
    diff --git a/docs/types/WorkerChoiceStrategy.html b/docs/types/WorkerChoiceStrategy.html index 18de0a32..6a370be5 100644 --- a/docs/types/WorkerChoiceStrategy.html +++ b/docs/types/WorkerChoiceStrategy.html @@ -1,2 +1,2 @@ -WorkerChoiceStrategy | poolifier - v4.2.10

    Type Alias WorkerChoiceStrategy

    WorkerChoiceStrategy: keyof typeof WorkerChoiceStrategies

    Worker choice strategy.

    -
    +WorkerChoiceStrategy | poolifier - v4.2.11

    Type Alias WorkerChoiceStrategy

    WorkerChoiceStrategy: keyof typeof WorkerChoiceStrategies

    Worker choice strategy.

    +
    diff --git a/docs/types/WorkerType.html b/docs/types/WorkerType.html index fb14798e..bff201ff 100644 --- a/docs/types/WorkerType.html +++ b/docs/types/WorkerType.html @@ -1,2 +1,2 @@ -WorkerType | poolifier - v4.2.10

    Type Alias WorkerType

    WorkerType: keyof typeof WorkerTypes

    Worker type.

    -
    +WorkerType | poolifier - v4.2.11

    Type Alias WorkerType

    WorkerType: keyof typeof WorkerTypes

    Worker type.

    +
    diff --git a/docs/types/Writable.html b/docs/types/Writable.html index 7058c1d4..4608c3a6 100644 --- a/docs/types/Writable.html +++ b/docs/types/Writable.html @@ -1,3 +1,3 @@ -Writable | poolifier - v4.2.10

    Type Alias Writable<T>Internal

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

    Remove readonly modifier from all properties of T.

    +Writable | poolifier - v4.2.11

    Type Alias Writable<T>Internal

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

    Remove readonly modifier from all properties of T.

    Type Parameters

    • T

      Type to remove readonly modifier.

      -
    +
    diff --git a/docs/variables/KillBehaviors.html b/docs/variables/KillBehaviors.html index 10d88901..c43b4a67 100644 --- a/docs/variables/KillBehaviors.html +++ b/docs/variables/KillBehaviors.html @@ -1,2 +1,2 @@ -KillBehaviors | poolifier - v4.2.10

    Variable KillBehaviorsConst

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

    Enumeration of kill behaviors.

    -
    +KillBehaviors | poolifier - v4.2.11

    Variable KillBehaviorsConst

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

    Enumeration of kill behaviors.

    +
    diff --git a/docs/variables/Measurements.html b/docs/variables/Measurements.html index acfeba39..281ed337 100644 --- a/docs/variables/Measurements.html +++ b/docs/variables/Measurements.html @@ -1,2 +1,2 @@ -Measurements | poolifier - v4.2.10

    Variable MeasurementsConst

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

    Enumeration of measurements.

    -
    +Measurements | poolifier - v4.2.11

    Variable MeasurementsConst

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

    Enumeration of measurements.

    +
    diff --git a/docs/variables/PoolEvents.html b/docs/variables/PoolEvents.html index fa338bd6..ba28a69d 100644 --- a/docs/variables/PoolEvents.html +++ b/docs/variables/PoolEvents.html @@ -1,2 +1,2 @@ -PoolEvents | poolifier - v4.2.10

    Variable PoolEventsConst

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

    Enumeration of pool events.

    -
    +PoolEvents | poolifier - v4.2.11

    Variable PoolEventsConst

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

    Enumeration of pool events.

    +
    diff --git a/docs/variables/PoolTypes.html b/docs/variables/PoolTypes.html index 021c216d..1b547c97 100644 --- a/docs/variables/PoolTypes.html +++ b/docs/variables/PoolTypes.html @@ -1,2 +1,2 @@ -PoolTypes | poolifier - v4.2.10

    Variable PoolTypesConst

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

    Enumeration of pool types.

    -
    +PoolTypes | poolifier - v4.2.11

    Variable PoolTypesConst

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

    Enumeration of pool types.

    +
    diff --git a/docs/variables/WorkerChoiceStrategies.html b/docs/variables/WorkerChoiceStrategies.html index 0119dea6..1937fb11 100644 --- a/docs/variables/WorkerChoiceStrategies.html +++ b/docs/variables/WorkerChoiceStrategies.html @@ -1,2 +1,2 @@ -WorkerChoiceStrategies | poolifier - v4.2.10

    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 - v4.2.11

    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.

    +
    diff --git a/docs/variables/WorkerTypes.html b/docs/variables/WorkerTypes.html index 8bb6a871..e3b0e922 100644 --- a/docs/variables/WorkerTypes.html +++ b/docs/variables/WorkerTypes.html @@ -1,2 +1,2 @@ -WorkerTypes | poolifier - v4.2.10

    Variable WorkerTypesConst

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

    Enumeration of worker types.

    -
    +WorkerTypes | poolifier - v4.2.11

    Variable WorkerTypesConst

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

    Enumeration of worker types.

    +
    -- 2.34.1