import { CircularArray } from '../circular-array'
import { Queue } from '../queue'
import type { Task } from '../utility-types'
+import { DEFAULT_TASK_NAME } from '../utils'
import {
type IWorker,
type IWorkerNode,
*/
export class WorkerNode<Worker extends IWorker, Data = unknown>
implements IWorkerNode<Worker, Data> {
+ /** @inheritdoc */
public readonly worker: Worker
+ /** @inheritdoc */
public readonly info: WorkerInfo
+ /** @inheritdoc */
+ public messageChannel?: MessageChannel
+ /** @inheritdoc */
public usage: WorkerUsage
- private readonly tasksUsage: Map<string, WorkerUsage>
+ private readonly taskFunctionsUsage: Map<string, WorkerUsage>
private readonly tasksQueue: Queue<Task<Data>>
+ private readonly tasksQueueBackPressureSize: number
/**
* Constructs a new worker node.
*
* @param worker - The worker.
* @param workerType - The worker type.
+ * @param poolMaxSize - The pool maximum size.
*/
- constructor (worker: Worker, workerType: WorkerType) {
+ constructor (worker: Worker, workerType: WorkerType, poolMaxSize: number) {
+ if (worker == null) {
+ throw new Error('Cannot construct a worker node without a worker')
+ }
+ if (workerType == null) {
+ throw new Error('Cannot construct a worker node without a worker type')
+ }
+ if (poolMaxSize == null) {
+ throw new Error(
+ 'Cannot construct a worker node without a pool maximum size'
+ )
+ }
+ if (isNaN(poolMaxSize)) {
+ throw new Error(
+ 'Cannot construct a worker node with a NaN pool maximum size'
+ )
+ }
this.worker = worker
this.info = this.initWorkerInfo(worker, workerType)
+ if (workerType === WorkerTypes.thread) {
+ this.messageChannel = new MessageChannel()
+ }
this.usage = this.initWorkerUsage()
- this.tasksUsage = new Map<string, WorkerUsage>()
+ this.taskFunctionsUsage = new Map<string, WorkerUsage>()
this.tasksQueue = new Queue<Task<Data>>()
+ this.tasksQueueBackPressureSize = Math.pow(poolMaxSize, 2)
}
/** @inheritdoc */
this.tasksQueue.clear()
}
+ /** @inheritdoc */
+ public hasBackPressure (): boolean {
+ return this.tasksQueue.size >= this.tasksQueueBackPressureSize
+ }
+
/** @inheritdoc */
public resetUsage (): void {
this.usage = this.initWorkerUsage()
- this.tasksUsage.clear()
+ this.taskFunctionsUsage.clear()
}
/** @inheritdoc */
public closeChannel (): void {
- if (this.info.messageChannel != null) {
- this.info.messageChannel?.port1.unref()
- this.info.messageChannel?.port2.unref()
- this.info.messageChannel?.port1.close()
- this.info.messageChannel?.port2.close()
- delete this.info.messageChannel
+ if (this.messageChannel != null) {
+ this.messageChannel?.port1.unref()
+ this.messageChannel?.port2.unref()
+ this.messageChannel?.port1.close()
+ this.messageChannel?.port2.close()
+ delete this.messageChannel
}
}
/** @inheritdoc */
- public getTaskWorkerUsage (name: string): WorkerUsage | undefined {
- if (!this.tasksUsage.has(name)) {
- this.tasksUsage.set(name, this.initTaskWorkerUsage(name))
+ public getTaskFunctionWorkerUsage (name: string): WorkerUsage | undefined {
+ if (!Array.isArray(this.info.taskFunctions)) {
+ throw new Error(
+ `Cannot get task function worker usage for task function name '${name}' when task function names list is not yet defined`
+ )
+ }
+ if (
+ Array.isArray(this.info.taskFunctions) &&
+ this.info.taskFunctions.length < 3
+ ) {
+ throw new Error(
+ `Cannot get task function worker usage for task function name '${name}' when task function names list has less than 3 elements`
+ )
+ }
+ if (name === DEFAULT_TASK_NAME) {
+ name = this.info.taskFunctions[1]
+ }
+ if (!this.taskFunctionsUsage.has(name)) {
+ this.taskFunctionsUsage.set(name, this.initTaskFunctionWorkerUsage(name))
}
- return this.tasksUsage.get(name)
+ return this.taskFunctionsUsage.get(name)
}
private initWorkerInfo (worker: Worker, workerType: WorkerType): WorkerInfo {
id: this.getWorkerId(worker, workerType),
type: workerType,
dynamic: false,
- ready: false,
- ...(workerType === WorkerTypes.thread && {
- messageChannel: new MessageChannel()
- })
+ ready: false
}
}
}
}
- private initTaskWorkerUsage (name: string): WorkerUsage {
+ private initTaskFunctionWorkerUsage (name: string): WorkerUsage {
const getTaskQueueSize = (): number => {
let taskQueueSize = 0
for (const task of this.tasksQueue) {