X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fworker.ts;h=841a2bcb1513ba3dc017d4b599ef61e3329611ab;hb=a788de39a01b042deb0707c2e92af99181b933d2;hp=05b559850c3a16f4d682f25acaf42e20a3f982e0;hpb=56960396878dec81e3ebeea5b76387efca8cc2dc;p=poolifier.git diff --git a/src/pools/worker.ts b/src/pools/worker.ts index 05b55985..841a2bcb 100644 --- a/src/pools/worker.ts +++ b/src/pools/worker.ts @@ -1,4 +1,6 @@ +import type { EventLoopUtilization } from 'node:perf_hooks' import type { CircularArray } from '../circular-array' +import type { Queue } from '../queue' /** * Callback invoked if the worker has received a message. @@ -37,23 +39,33 @@ export type ExitHandler = ( */ export interface Task { /** - * Input data that will be passed to the worker. + * Task name. + */ + readonly name?: string + /** + * Task input data that will be passed to the worker. */ readonly data?: Data /** - * UUID of the message. + * Timestamp. + */ + readonly timestamp?: number + /** + * Message UUID. */ readonly id?: string } /** * Worker tasks usage statistics. + * + * @internal */ export interface TasksUsage { /** * Number of tasks executed. */ - run: number + ran: number /** * Number of tasks running. */ @@ -74,10 +86,30 @@ export interface TasksUsage { * Median tasks runtime. */ medRunTime: number + /** + * Tasks wait time. + */ + waitTime: number + /** + * Tasks wait time history. + */ + waitTimeHistory: CircularArray + /** + * Average tasks wait time. + */ + avgWaitTime: number + /** + * Median tasks wait time. + */ + medWaitTime: number /** * Number of tasks errored. */ error: number + /** + * Event loop utilization. + */ + elu: EventLoopUtilization | undefined } /** @@ -88,14 +120,14 @@ export interface IWorker { * Register an event listener. * * @param event - The event. - * @param handler - The event listener. + * @param handler - The event handler. */ on: ((event: 'message', handler: MessageHandler) => void) & ((event: 'error', handler: ErrorHandler) => void) & ((event: 'online', handler: OnlineHandler) => void) & ((event: 'exit', handler: ExitHandler) => void) /** - * Register a listener to the exit event that will only performed once. + * Register a listener to the exit event that will only be performed once. * * @param event - `'exit'`. * @param handler - The exit handler. @@ -122,5 +154,5 @@ export interface WorkerNode { /** * Worker node tasks queue. */ - readonly tasksQueue: Array> + readonly tasksQueue: Queue> }