X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fworker.ts;h=07eabdfe4b43d28a7ecc1238b6f422be04d83ef1;hb=25f5b5de1c522d29f7a16597245a2f7c9434b124;hp=b6dddd1d59ac24916dd8ab49591dc31c1edfa93a;hpb=8604aaabd5aef29ed9b824a2d1dcdb53490ea8ad;p=poolifier.git diff --git a/src/pools/worker.ts b/src/pools/worker.ts index b6dddd1d..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 { @@ -63,9 +62,9 @@ export interface Task { */ export interface MeasurementStatistics { /** - * Measurement aggregation. + * Measurement aggregate. */ - aggregation: number + aggregate: number /** * Measurement average. */ @@ -80,6 +79,17 @@ export interface MeasurementStatistics { history: CircularArray } +/** + * Event loop utilization measurement statistics. + * + * @internal + */ +export interface EventLoopUtilizationMeasurementStatistics { + idle: MeasurementStatistics + active: MeasurementStatistics + utilization: number +} + /** * Task statistics. * @@ -87,19 +97,23 @@ export interface MeasurementStatistics { */ 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 /** - * Number of tasks failed. + * Maximum number of queued tasks. + */ + readonly maxQueued: number + /** + * Number of failed tasks. */ failed: number } @@ -123,9 +137,9 @@ export interface WorkerUsage { */ waitTime: MeasurementStatistics /** - * Event loop utilization. + * Tasks event loop utilization statistics. */ - elu: EventLoopUtilization | undefined + elu: EventLoopUtilizationMeasurementStatistics } /** @@ -155,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 {