X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fthread%2Ffixed.ts;h=a37ccbf76b5864b8cc4f27b847596d7b9c533d38;hb=3032893add6cc97da7b0600e21df2865ad1f675c;hp=abd1b6b8b081ac2740ac96ea6a1265a690ff407b;hpb=7c0ba92006a5c188738ffc5ff642c51f172df3d6;p=poolifier.git diff --git a/src/pools/thread/fixed.ts b/src/pools/thread/fixed.ts index abd1b6b8..a37ccbf7 100644 --- a/src/pools/thread/fixed.ts +++ b/src/pools/thread/fixed.ts @@ -1,7 +1,12 @@ -import { isMainThread, MessageChannel, SHARE_ENV, Worker } from 'worker_threads' +import { + isMainThread, + MessageChannel, + SHARE_ENV, + Worker +} from 'node:worker_threads' import type { Draft, MessageValue } from '../../utility-types' -import type { PoolOptions } from '../abstract-pool' import { AbstractPool } from '../abstract-pool' +import type { PoolOptions } from '../pool' import { PoolType } from '../pool-internal' /** @@ -16,9 +21,8 @@ export type ThreadWorkerWithMessageChannel = Worker & Draft * * This pool selects the threads in a round robin fashion. * - * @template Data Type of data sent to the worker. This can only be serializable data. - * @template Response Type of response of execution. This can only be serializable data. - * + * @typeParam Data - Type of data sent to the worker. This can only be serializable data. + * @typeParam Response - Type of response of execution. This can only be serializable data. * @author [Alessandro Pio Ardizio](https://github.com/pioardi) * @since 0.0.1 */ @@ -29,9 +33,9 @@ export class FixedThreadPool< /** * Constructs a new poolifier fixed thread pool. * - * @param numberOfThreads Number of threads for this pool. - * @param filePath Path to an implementation of a `ThreadWorker` file, which can be relative or absolute. - * @param opts Options for this fixed thread pool. Default: `{}` + * @param numberOfThreads - Number of threads for this pool. + * @param filePath - Path to an implementation of a `ThreadWorker` file, which can be relative or absolute. + * @param opts - Options for this fixed thread pool. */ public constructor ( numberOfThreads: number, @@ -41,11 +45,12 @@ export class FixedThreadPool< super(numberOfThreads, filePath, opts) } + /** {@inheritDoc} */ protected isMain (): boolean { return isMainThread } - /** @inheritdoc */ + /** {@inheritDoc} */ public async destroyWorker ( worker: ThreadWorkerWithMessageChannel ): Promise { @@ -53,6 +58,7 @@ export class FixedThreadPool< await worker.terminate() } + /** {@inheritDoc} */ protected sendToWorker ( worker: ThreadWorkerWithMessageChannel, message: MessageValue @@ -60,35 +66,37 @@ export class FixedThreadPool< worker.postMessage(message) } - /** @inheritdoc */ - public registerWorkerMessageListener ( + /** {@inheritDoc} */ + public registerWorkerMessageListener( messageChannel: ThreadWorkerWithMessageChannel, listener: (message: MessageValue) => void ): void { messageChannel.port2?.on('message', listener) } + /** {@inheritDoc} */ protected createWorker (): ThreadWorkerWithMessageChannel { return new Worker(this.filePath, { env: SHARE_ENV }) } + /** {@inheritDoc} */ protected afterWorkerSetup (worker: ThreadWorkerWithMessageChannel): void { const { port1, port2 } = new MessageChannel() worker.postMessage({ parent: port1 }, [port1]) worker.port1 = port1 worker.port2 = port2 - // Listen worker messages. + // Listen to worker messages. this.registerWorkerMessageListener(worker, super.workerListener()) } - /** @inheritdoc */ + /** {@inheritDoc} */ public get type (): PoolType { return PoolType.FIXED } - /** @inheritdoc */ + /** {@inheritDoc} */ public get busy (): boolean { return this.internalGetBusyStatus() }