-import fs from 'fs';
+import type { EventEmitter } from 'node:events';
+import { existsSync } from 'node:fs';
+import type { Worker } from 'node:worker_threads';
-import WorkerConstants from './WorkerConstants';
-import type { WorkerData, WorkerOptions } from '../types/Worker';
+import type { ErrorHandler, ExitHandler, PoolEmitter, PoolInfo } from 'poolifier';
-export default abstract class WorkerAbstract<T extends WorkerData> {
+import { WorkerConstants } from './WorkerConstants';
+import type { SetInfo, WorkerData, WorkerOptions } from './WorkerTypes';
+import { defaultErrorHandler, defaultExitHandler } from './WorkerUtils';
+
+export abstract class WorkerAbstract<T extends WorkerData> {
protected readonly workerScript: string;
protected readonly workerOptions: WorkerOptions;
+ public abstract readonly info: PoolInfo | SetInfo;
public abstract readonly size: number;
public abstract readonly maxElementsPerWorker: number | undefined;
+ public abstract readonly emitter: EventEmitter | PoolEmitter | undefined;
/**
* `WorkerAbstract` constructor.
poolMaxSize: WorkerConstants.DEFAULT_POOL_MAX_SIZE,
elementsPerWorker: WorkerConstants.DEFAULT_ELEMENTS_PER_WORKER,
poolOptions: {},
- messageHandler: () => {
- /* This is intentional */
- },
}
) {
- if (!workerScript) {
+ if (workerScript === null || workerScript === undefined) {
throw new Error('Worker script is not defined');
}
- if (!fs.existsSync(workerScript)) {
+ if (typeof workerScript === 'string' && workerScript.trim().length === 0) {
+ throw new Error('Worker script is empty');
+ }
+ if (!existsSync(workerScript)) {
throw new Error('Worker script file does not exist');
}
this.workerScript = workerScript;
this.workerOptions = workerOptions;
+ this.workerOptions.poolOptions?.messageHandler?.bind(this);
+ this.workerOptions.poolOptions.errorHandler = (
+ this.workerOptions?.poolOptions?.errorHandler ?? defaultErrorHandler
+ ).bind(this) as ErrorHandler<Worker>;
+ this.workerOptions.poolOptions?.onlineHandler?.bind(this);
+ this.workerOptions.poolOptions.exitHandler = (
+ this.workerOptions?.poolOptions?.exitHandler ?? defaultExitHandler
+ ).bind(this) as ExitHandler<Worker>;
}
+ /**
+ * Starts the worker pool/set.
+ */
public abstract start(): Promise<void>;
+ /**
+ * Stops the worker pool/set.
+ */
public abstract stop(): Promise<void>;
+ /**
+ * Adds a task element to the worker pool/set.
+ *
+ * @param elementData -
+ */
public abstract addElement(elementData: T): Promise<void>;
}