X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fthread%2Ffixed.ts;h=a37ccbf76b5864b8cc4f27b847596d7b9c533d38;hb=3032893add6cc97da7b0600e21df2865ad1f675c;hp=3212678f8635bc3dc3a67ed6500e5ab38ee38b66;hpb=a76fac14098cf2138cf8d6997ac7c89d8c3ae508;p=poolifier.git diff --git a/src/pools/thread/fixed.ts b/src/pools/thread/fixed.ts index 3212678f..a37ccbf7 100644 --- a/src/pools/thread/fixed.ts +++ b/src/pools/thread/fixed.ts @@ -1,4 +1,9 @@ -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 { AbstractPool } from '../abstract-pool' import type { PoolOptions } from '../pool' @@ -16,8 +21,8 @@ export type ThreadWorkerWithMessageChannel = Worker & Draft * * This pool selects the threads in a round robin fashion. * - * @template DataType of data sent to the worker. This can only be serializable data. - * @template ResponseType 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 */ @@ -28,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. + * @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, @@ -40,12 +45,12 @@ export class FixedThreadPool< super(numberOfThreads, filePath, opts) } - /** @inheritDoc */ + /** {@inheritDoc} */ protected isMain (): boolean { return isMainThread } - /** @inheritDoc */ + /** {@inheritDoc} */ public async destroyWorker ( worker: ThreadWorkerWithMessageChannel ): Promise { @@ -53,7 +58,7 @@ export class FixedThreadPool< await worker.terminate() } - /** @inheritDoc */ + /** {@inheritDoc} */ protected sendToWorker ( worker: ThreadWorkerWithMessageChannel, message: MessageValue @@ -61,37 +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 */ + /** {@inheritDoc} */ protected createWorker (): ThreadWorkerWithMessageChannel { return new Worker(this.filePath, { env: SHARE_ENV }) } - /** @inheritDoc */ + /** {@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() }