import {
- type MessageChannel,
- type MessagePort,
- SHARE_ENV,
+ isMainThread,
type TransferListItem,
- Worker,
- type WorkerOptions,
- isMainThread
+ type Worker
} from 'node:worker_threads'
-import type { MessageValue } from '../../utility-types'
-import { AbstractPool } from '../abstract-pool'
-import { type PoolOptions, type PoolType, PoolTypes } from '../pool'
-import { type WorkerType, WorkerTypes } from '../worker'
+
+import type { MessageValue } from '../../utility-types.js'
+import { AbstractPool } from '../abstract-pool.js'
+import { type PoolOptions, type PoolType, PoolTypes } from '../pool.js'
+import { type WorkerType, WorkerTypes } from '../worker.js'
/**
* Options for a poolifier thread pool.
*/
-export interface ThreadPoolOptions extends PoolOptions<Worker> {
- /**
- * Worker options.
- *
- * @see https://nodejs.org/api/worker_threads.html#new-workerfilename-options
- */
- workerOptions?: WorkerOptions
-}
+export type ThreadPoolOptions = PoolOptions<Worker>
/**
* A thread pool with a fixed number of threads.
public constructor (
numberOfThreads: number,
filePath: string,
- protected readonly opts: ThreadPoolOptions = {}
+ opts: ThreadPoolOptions = {},
+ maximumNumberOfThreads?: number
) {
- super(numberOfThreads, filePath, opts)
+ super(numberOfThreads, filePath, opts, maximumNumberOfThreads)
}
/** @inheritDoc */
return isMainThread
}
- /** @inheritDoc */
- protected async destroyWorkerNode (workerNodeKey: number): Promise<void> {
- this.flushTasksQueue(workerNodeKey)
- // FIXME: wait for tasks to be finished
- const workerNode = this.workerNodes[workerNodeKey]
- const worker = workerNode.worker
- const waitWorkerExit = new Promise<void>((resolve) => {
- worker.on('exit', () => {
- resolve()
- })
- })
- await this.sendKillMessageToWorker(workerNodeKey, worker.threadId)
- workerNode.closeChannel()
- await worker.terminate()
- await waitWorkerExit
- }
-
/** @inheritDoc */
protected sendToWorker (
workerNodeKey: number,
message: MessageValue<Data>,
- transferList?: TransferListItem[]
+ transferList?: readonly TransferListItem[]
): void {
- (
- this.workerNodes[workerNodeKey].messageChannel as MessageChannel
- ).port1.postMessage(message, transferList)
+ this.workerNodes[workerNodeKey]?.messageChannel?.port1.postMessage(
+ {
+ ...message,
+ workerId: this.getWorkerInfo(workerNodeKey)?.id
+ } satisfies MessageValue<Data>,
+ transferList
+ )
}
/** @inheritDoc */
protected sendStartupMessageToWorker (workerNodeKey: number): void {
- const worker = this.workerNodes[workerNodeKey].worker
- const port2: MessagePort = (
- this.workerNodes[workerNodeKey].messageChannel as MessageChannel
- ).port2
- worker.postMessage(
+ const workerNode = this.workerNodes[workerNodeKey]
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ const port2 = workerNode.messageChannel!.port2
+ workerNode.worker.postMessage(
{
ready: false,
- workerId: worker.threadId,
+ workerId: this.getWorkerInfo(workerNodeKey)?.id,
port: port2
- },
+ } satisfies MessageValue<Data>,
[port2]
)
}
workerNodeKey: number,
listener: (message: MessageValue<Message>) => void
): void {
- (
- this.workerNodes[workerNodeKey].messageChannel as MessageChannel
- ).port1.on('message', listener)
+ this.workerNodes[workerNodeKey].messageChannel?.port1.on(
+ 'message',
+ listener
+ )
+ }
+
+ /** @inheritDoc */
+ protected registerOnceWorkerMessageListener<Message extends Data | Response>(
+ workerNodeKey: number,
+ listener: (message: MessageValue<Message>) => void
+ ): void {
+ this.workerNodes[workerNodeKey].messageChannel?.port1.once(
+ 'message',
+ listener
+ )
+ }
+
+ /** @inheritDoc */
+ protected deregisterWorkerMessageListener<Message extends Data | Response>(
+ workerNodeKey: number,
+ listener: (message: MessageValue<Message>) => void
+ ): void {
+ this.workerNodes[workerNodeKey].messageChannel?.port1.off(
+ 'message',
+ listener
+ )
+ }
+
+ /** @inheritDoc */
+ protected shallCreateDynamicWorker (): boolean {
+ return false
}
/** @inheritDoc */
- protected createWorker (): Worker {
- return new Worker(this.filePath, {
- env: SHARE_ENV,
- ...this.opts.workerOptions
- })
+ protected checkAndEmitDynamicWorkerCreationEvents (): void {
+ /* noop */
}
/** @inheritDoc */