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, type PoolInfo } 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 info(): PoolInfo {
  36     return this.pool.info;
  37   }
  38
  39   get size(): number {
  40     return this.pool.info.workerNodes;
  41   }
  42
  43   get maxElementsPerWorker(): number | undefined {
  44     return undefined;
  45   }
  46
  47   get emitter(): EventEmitterAsyncResource | undefined {
  48     return this.pool?.emitter;
  49   }
  50
  51   /** @inheritDoc */
  52   public async start(): Promise<void> {
  53     // This is intentional
  54   }
  55
  56   /** @inheritDoc */
  57   public async stop(): Promise<void> {
  58     return this.pool.destroy();
  59   }
  60
  61   /** @inheritDoc */
  62   public async addElement(elementData: WorkerData): Promise<void> {
  63     await this.pool.execute(elementData);
  64     // Start element sequentially to optimize memory at startup
  65     this.workerOptions.elementStartDelay > 0 && (await sleep(this.workerOptions.elementStartDelay));
  66   }
  67 }