import { MessageChannel } from 'node:worker_threads'
import { CircularArray } from '../circular-array'
-import { Queue } from '../queue'
import type { Task } from '../utility-types'
-import { DEFAULT_TASK_NAME } from '../utils'
+import { DEFAULT_TASK_NAME, once } from '../utils'
+import { Deque } from '../deque'
import {
type IWorker,
type IWorkerNode,
public messageChannel?: MessageChannel
/** @inheritdoc */
public usage: WorkerUsage
+ /** @inheritdoc */
+ public tasksQueueBackPressureSize: number
+ /** @inheritdoc */
+ public onBackPressure?: (workerId: number) => void
+ /** @inheritdoc */
+ public onEmptyQueue?: (workerId: number) => void
private readonly taskFunctionsUsage: Map<string, WorkerUsage>
- private readonly tasksQueue: Queue<Task<Data>>
- private readonly tasksQueueBackPressureSize: number
+ private readonly tasksQueue: Deque<Task<Data>>
/**
* Constructs a new worker node.
*
* @param worker - The worker.
* @param workerType - The worker type.
- * @param poolMaxSize - The pool maximum size.
+ * @param tasksQueueBackPressureSize - The tasks queue back pressure size.
*/
- constructor (worker: Worker, workerType: WorkerType, poolMaxSize: number) {
+ constructor (
+ worker: Worker,
+ workerType: WorkerType,
+ tasksQueueBackPressureSize: number
+ ) {
if (worker == null) {
throw new TypeError('Cannot construct a worker node without a worker')
}
'Cannot construct a worker node without a worker type'
)
}
- if (poolMaxSize == null) {
+ if (tasksQueueBackPressureSize == null) {
throw new TypeError(
- 'Cannot construct a worker node without a pool maximum size'
+ 'Cannot construct a worker node without a tasks queue back pressure size'
)
}
- if (isNaN(poolMaxSize)) {
+ if (!Number.isSafeInteger(tasksQueueBackPressureSize)) {
throw new TypeError(
- 'Cannot construct a worker node with a NaN pool maximum size'
+ 'Cannot construct a worker node with a tasks queue back pressure size that is not an integer'
)
}
this.worker = worker
}
this.usage = this.initWorkerUsage()
this.taskFunctionsUsage = new Map<string, WorkerUsage>()
- this.tasksQueue = new Queue<Task<Data>>()
- this.tasksQueueBackPressureSize = Math.pow(poolMaxSize, 2)
+ this.tasksQueue = new Deque<Task<Data>>()
+ this.tasksQueueBackPressureSize = tasksQueueBackPressureSize
}
/** @inheritdoc */
return this.tasksQueue.size
}
- /**
- * Tasks queue maximum size.
- *
- * @returns The tasks queue maximum size.
- */
- private tasksQueueMaxSize (): number {
- return this.tasksQueue.maxSize
+ /** @inheritdoc */
+ public enqueueTask (task: Task<Data>): number {
+ const tasksQueueSize = this.tasksQueue.push(task)
+ if (this.onBackPressure != null && this.hasBackPressure()) {
+ once(this.onBackPressure, this)(this.info.id as number)
+ }
+ return tasksQueueSize
}
/** @inheritdoc */
- public enqueueTask (task: Task<Data>): number {
- return this.tasksQueue.enqueue(task)
+ public unshiftTask (task: Task<Data>): number {
+ const tasksQueueSize = this.tasksQueue.unshift(task)
+ if (this.onBackPressure != null && this.hasBackPressure()) {
+ once(this.onBackPressure, this)(this.info.id as number)
+ }
+ return tasksQueueSize
}
/** @inheritdoc */
public dequeueTask (): Task<Data> | undefined {
- return this.tasksQueue.dequeue()
+ const task = this.tasksQueue.shift()
+ if (this.onEmptyQueue != null && this.tasksQueue.size === 0) {
+ once(this.onEmptyQueue, this)(this.info.id as number)
+ }
+ return task
+ }
+
+ /** @inheritdoc */
+ public popTask (): Task<Data> | undefined {
+ const task = this.tasksQueue.pop()
+ if (this.onEmptyQueue != null && this.tasksQueue.size === 0) {
+ once(this.onEmptyQueue, this)(this.info.id as number)
+ }
+ return task
}
/** @inheritdoc */
private initWorkerUsage (): WorkerUsage {
const getTasksQueueSize = (): number => {
- return this.tasksQueueSize()
+ return this.tasksQueue.size
}
const getTasksQueueMaxSize = (): number => {
- return this.tasksQueueMaxSize()
+ return this.tasksQueue.maxSize
}
return {
tasks: {
}
private initTaskFunctionWorkerUsage (name: string): WorkerUsage {
- const getTaskQueueSize = (): number => {
- let taskQueueSize = 0
+ const getTaskFunctionQueueSize = (): number => {
+ let taskFunctionQueueSize = 0
for (const task of this.tasksQueue) {
- if (task.name === name) {
- ++taskQueueSize
+ if (
+ (task.name === DEFAULT_TASK_NAME &&
+ name === (this.info.taskFunctions as string[])[1]) ||
+ (task.name !== DEFAULT_TASK_NAME && name === task.name)
+ ) {
+ ++taskFunctionQueueSize
}
}
- return taskQueueSize
+ return taskFunctionQueueSize
}
return {
tasks: {
executed: 0,
executing: 0,
get queued (): number {
- return getTaskQueueSize()
+ return getTaskFunctionQueueSize()
},
failed: 0
},