X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;ds=sidebyside;f=src%2Fpools%2Fthread%2Ffixed.ts;h=bfd6f016d0d4f08525d1c19435d4a138e2a404a0;hb=45dbbb14328a173cad05ddcf21b5acf7f6460bb8;hp=badca517585d346072debabc0c306253a513c08c;hpb=d3c8a1a8022726094160d1413f1f289c5d84d715;p=poolifier.git diff --git a/src/pools/thread/fixed.ts b/src/pools/thread/fixed.ts index badca517..bfd6f016 100644 --- a/src/pools/thread/fixed.ts +++ b/src/pools/thread/fixed.ts @@ -3,12 +3,20 @@ import type { Draft, JSONValue, MessageValue } from '../../utility-types' import type { PoolOptions } from '../abstract-pool' import { AbstractPool } from '../abstract-pool' +/** + * A thread worker with message channels for communication between main thread and thread worker. + */ export type ThreadWorkerWithMessageChannel = Worker & Draft /** - * A thread pool with a static number of threads, is possible to execute tasks in sync or async mode as you prefer. + * A thread pool with a fixed number of threads. + * + * It is possible to perform tasks in sync or asynchronous mode as you prefer. * - * This pool will select the worker thread in a round robin fashion. + * This pool selects the threads in a round robin fashion. + * + * @template Data Type of data sent to the worker. + * @template Response Type of response of execution. * * @author [Alessandro Pio Ardizio](https://github.com/pioardi) * @since 0.0.1 @@ -18,16 +26,18 @@ export class FixedThreadPool< Response extends JSONValue = JSONValue > extends AbstractPool { /** - * @param numThreads Num of threads for this worker pool. - * @param filePath A file path with implementation of `ThreadWorker` class, relative path is fine. - * @param opts An object with possible options for example `errorHandler`, `onlineHandler`. Default: `{ maxTasks: 1000 }` + * 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: `{ maxTasks: 1000 }` */ public constructor ( - numThreads: number, + numberOfThreads: number, filePath: string, opts: PoolOptions = { maxTasks: 1000 } ) { - super(numThreads, filePath, opts) + super(numberOfThreads, filePath, opts) } protected isMain (): boolean { @@ -61,15 +71,13 @@ export class FixedThreadPool< port.port2?.removeListener('message', listener) } - protected newWorker (): ThreadWorkerWithMessageChannel { + protected createWorker (): ThreadWorkerWithMessageChannel { return new Worker(this.filePath, { env: SHARE_ENV }) } - protected afterNewWorkerPushed ( - worker: ThreadWorkerWithMessageChannel - ): void { + protected afterWorkerSetup (worker: ThreadWorkerWithMessageChannel): void { const { port1, port2 } = new MessageChannel() worker.postMessage({ parent: port1 }, [port1]) worker.port1 = port1