perf: improve node eligibility branching on worker choice strategies
[poolifier.git] / src / pools / worker.ts
index 6e81112d27e62a532f519411cc72f1cefef80059..7a8c59e7730eba9be39ae972f94022a8a65a14ce 100644 (file)
@@ -96,6 +96,10 @@ export interface TaskStatistics {
    * Maximum number of queued tasks.
    */
   readonly maxQueued?: number
+  /**
+   * Number of stolen tasks.
+   */
+  stolen: number
   /**
    * Number of failed tasks.
    */
@@ -195,6 +199,9 @@ export interface IWorker {
   readonly once: (event: 'exit', handler: ExitHandler<this>) => void
 }
 
+export type EmptyQueueCallback = (workerId: number) => void
+export type BackPressureCallback = EmptyQueueCallback
+
 /**
  * Worker node interface.
  *
@@ -211,14 +218,14 @@ export interface IWorkerNode<Worker extends IWorker, Data = unknown> {
    * Worker info.
    */
   readonly info: WorkerInfo
-  /**
-   * Message channel (worker_threads only).
-   */
-  readonly messageChannel?: MessageChannel
   /**
    * Worker usage statistics.
    */
   usage: WorkerUsage
+  /**
+   * Message channel (worker_threads only).
+   */
+  readonly messageChannel?: MessageChannel
   /**
    * Tasks queue back pressure size.
    * This is the number of tasks that can be enqueued before the worker node has back pressure.
@@ -229,13 +236,13 @@ export interface IWorkerNode<Worker extends IWorker, Data = unknown> {
    *
    * @param workerId - The worker id.
    */
-  onBackPressure?: (workerId: number) => void
+  onBackPressure?: EmptyQueueCallback
   /**
    * Callback invoked when worker node tasks queue is empty.
    *
    * @param workerId - The worker id.
    */
-  onEmptyQueue?: (workerId: number) => void
+  onEmptyQueue?: BackPressureCallback
   /**
    * Tasks queue size.
    *