X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fworker.ts;h=07eabdfe4b43d28a7ecc1238b6f422be04d83ef1;hb=25f5b5de1c522d29f7a16597245a2f7c9434b124;hp=4d935a113336921a5f49e6858046b07a863096fd;hpb=a4e07f7216246b772e13783937a97c87105b8fc3;p=poolifier.git diff --git a/src/pools/worker.ts b/src/pools/worker.ts index 4d935a11..07eabdfe 100644 --- a/src/pools/worker.ts +++ b/src/pools/worker.ts @@ -1,4 +1,3 @@ -import type { EventLoopUtilization } from 'node:perf_hooks' import type { CircularArray } from '../circular-array' import type { Queue } from '../queue' @@ -7,7 +6,7 @@ import type { Queue } from '../queue' */ export type MessageHandler = ( this: Worker, - m: unknown + message: unknown ) => void /** @@ -15,7 +14,7 @@ export type MessageHandler = ( */ export type ErrorHandler = ( this: Worker, - e: Error + error: Error ) => void /** @@ -28,13 +27,13 @@ export type OnlineHandler = (this: Worker) => void */ export type ExitHandler = ( this: Worker, - code: number + exitCode: number ) => void /** * Message object that is passed as a task between main worker and worker. * - * @typeParam Data - Type of data sent to the worker. This can only be serializable data. + * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data. * @internal */ export interface Task { @@ -57,50 +56,64 @@ export interface Task { } /** - * Measure statistics. + * Measurement statistics. * * @internal */ -export interface MeasureStatistics { +export interface MeasurementStatistics { /** - * Measure aggregation. + * Measurement aggregate. */ - aggregation: number + aggregate: number /** - * Measure average. + * Measurement average. */ average: number /** - * Measure median. + * Measurement median. */ median: number /** - * Measure history. + * Measurement history. */ history: CircularArray } /** - * Task statistics. + * Event loop utilization measurement statistics. * * @internal */ +export interface EventLoopUtilizationMeasurementStatistics { + idle: MeasurementStatistics + active: MeasurementStatistics + utilization: number +} +/** + * Task statistics. + * + * @internal + */ export interface TaskStatistics { /** - * Number of tasks executed. + * Number of executed tasks. */ executed: number /** - * Number of tasks executing. + * Number of executing tasks. */ executing: number /** - * Number of tasks queued. + * Number of queued tasks. + */ + readonly queued: number + /** + * Maximum number of queued tasks. */ - queued: number + readonly maxQueued: number /** - * Number of tasks failed. + * Number of failed tasks. */ failed: number } @@ -118,15 +131,15 @@ export interface WorkerUsage { /** * Tasks runtime statistics. */ - runTime: MeasureStatistics + runTime: MeasurementStatistics /** * Tasks wait time statistics. */ - waitTime: MeasureStatistics + waitTime: MeasurementStatistics /** - * Event loop utilization. + * Tasks event loop utilization statistics. */ - elu: EventLoopUtilization | undefined + elu: EventLoopUtilizationMeasurementStatistics } /** @@ -156,7 +169,7 @@ export interface IWorker { * Worker node interface. * * @typeParam Worker - Type of worker. - * @typeParam Data - Type of data sent to the worker. This can only be serializable data. + * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data. * @internal */ export interface WorkerNode {