src/worker/WorkerStaticPool.ts

   1 import type EventEmitterAsyncResource from 'node:events';
   2 import type { Worker } from 'node:worker_threads';
   3
   4 import { type ErrorHandler, type ExitHandler, FixedThreadPool } from 'poolifier';
   5
   6 import { WorkerAbstract } from './WorkerAbstract';
   7 import type { WorkerData, WorkerOptions } from './WorkerTypes';
   8 import { defaultErrorHandler, defaultExitHandler, sleep } from './WorkerUtils';
   9
  10 export class WorkerStaticPool extends WorkerAbstract<WorkerData> {
  11   private readonly pool: FixedThreadPool<WorkerData>;
  12
  13   /**
  14    * Create a new `WorkerStaticPool`.
  15    *
  16    * @param workerScript -
  17    * @param workerOptions -
  18    */
  19   constructor(workerScript: string, workerOptions?: WorkerOptions) {
  20     super(workerScript, workerOptions);
  21     this.workerOptions.poolOptions.errorHandler = (
  22       this.workerOptions?.poolOptions?.errorHandler ?? defaultErrorHandler
  23     ).bind(this) as ErrorHandler<Worker>;
  24     this.workerOptions.poolOptions.exitHandler = (
  25       this.workerOptions?.poolOptions?.exitHandler ?? defaultExitHandler
  26     ).bind(this) as ExitHandler<Worker>;
  27     this.workerOptions.poolOptions.messageHandler.bind(this);
  28     this.pool = new FixedThreadPool(
  29       this.workerOptions.poolMaxSize,
  30       this.workerScript,
  31       this.workerOptions.poolOptions
  32     );
  33   }
  34
  35   get size(): number {
  36     return this.pool.workerNodes.length;
  37   }
  38
  39   get maxElementsPerWorker(): number | undefined {
  40     return undefined;
  41   }
  42
  43   get emitter(): EventEmitterAsyncResource | undefined {
  44     return this.pool?.emitter;
  45   }
  46
  47   /** @inheritDoc */
  48   public async start(): Promise<void> {
  49     // This is intentional
  50   }
  51
  52   /** @inheritDoc */
  53   public async stop(): Promise<void> {
  54     return this.pool.destroy();
  55   }
  56
  57   /** @inheritDoc */
  58   public async addElement(elementData: WorkerData): Promise<void> {
  59     await this.pool.execute(elementData);
  60     // Start element sequentially to optimize memory at startup
  61     this.workerOptions.elementStartDelay > 0 && (await sleep(this.workerOptions.elementStartDelay));
  62   }
  63 }