X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fworker.ts;h=43e7fc608cb9be8d569ade1acc7dc72fe2194cad;hb=bc098b7f00e53e0edd6adb80fff694ef1a896c69;hp=be134f05f539b87bf254bbfb71e68c90e360946c;hpb=a9780ad2992ef19ef824da2d796433fc7f193ec8;p=poolifier.git diff --git a/src/pools/worker.ts b/src/pools/worker.ts index be134f05..43e7fc60 100644 --- a/src/pools/worker.ts +++ b/src/pools/worker.ts @@ -132,7 +132,7 @@ export interface WorkerInfo { /** * Worker type. */ - type: WorkerType + readonly type: WorkerType /** * Dynamic flag. */ @@ -144,7 +144,7 @@ export interface WorkerInfo { /** * Task function names. */ - taskFunctions?: string[] + taskFunctionNames?: string[] } /** @@ -171,6 +171,15 @@ export interface WorkerUsage { readonly elu: EventLoopUtilizationMeasurementStatistics } +/** + * Worker choice strategy data. + * + * @internal + */ +export interface StrategyData { + virtualTaskEndTimestamp?: number +} + /** * Worker interface. */ @@ -199,7 +208,14 @@ export interface IWorker { readonly once: (event: 'exit', handler: ExitHandler) => void } -export type WorkerNodeEventCallback = (workerId: number) => void +/** + * Worker node event detail. + * + * @internal + */ +export interface WorkerNodeEventDetail { + workerId: number +} /** * Worker node interface. @@ -208,7 +224,8 @@ export type WorkerNodeEventCallback = (workerId: number) => void * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data. * @internal */ -export interface IWorkerNode { +export interface IWorkerNode + extends EventTarget { /** * Worker. */ @@ -220,7 +237,12 @@ export interface IWorkerNode { /** * Worker usage statistics. */ - usage: WorkerUsage + readonly usage: WorkerUsage + /** + * Worker choice strategy data. + * This is used to store data that is specific to the worker choice strategy. + */ + strategyData?: StrategyData /** * Message channel (worker_threads only). */ @@ -230,18 +252,6 @@ export interface IWorkerNode { * This is the number of tasks that can be enqueued before the worker node has back pressure. */ tasksQueueBackPressureSize: number - /** - * Callback invoked when worker node tasks queue is back pressured. - * - * @param workerId - The worker id. - */ - onBackPressure?: WorkerNodeEventCallback - /** - * Callback invoked when worker node tasks queue is empty. - * - * @param workerId - The worker id. - */ - onEmptyQueue?: WorkerNodeEventCallback /** * Tasks queue size. * @@ -299,4 +309,11 @@ export interface IWorkerNode { * @returns The task function worker usage statistics if the task function worker usage statistics are initialized, `undefined` otherwise. */ readonly getTaskFunctionWorkerUsage: (name: string) => WorkerUsage | undefined + /** + * Deletes task function worker usage statistics. + * + * @param name - The task function name. + * @returns `true` if the task function worker usage statistics were deleted, `false` otherwise. + */ + readonly deleteTaskFunctionWorkerUsage: (name: string) => boolean }