X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=docs%2Fapi.md;h=8e3c77076f231bda67064b51eba22cd4150c3d77;hb=bfc75ccaf49d915d2b7e73c92360787b3245321a;hp=d2cc2ba7747c31f7bdf0b0efbc204ae29919639d;hpb=30500265f2a78b3d472c9c1d0ca5e006306113aa;p=poolifier.git diff --git a/docs/api.md b/docs/api.md index d2cc2ba7..8e3c7707 100644 --- a/docs/api.md +++ b/docs/api.md @@ -8,7 +8,11 @@ - [`pool.execute(data, name, transferList)`](#poolexecutedata-name-transferlist) - [`pool.start()`](#poolstart) - [`pool.destroy()`](#pooldestroy) + - [`pool.hasTaskFunction(name)`](#poolhastaskfunctionname) + - [`pool.addTaskFunction(name, fn)`](#pooladdtaskfunctionname-fn) + - [`pool.removeTaskFunction(name)`](#poolremovetaskfunctionname) - [`pool.listTaskFunctionNames()`](#poollisttaskfunctionnames) + - [`pool.setDefaultTaskFunction(name)`](#poolsetdefaulttaskfunctionname) - [`PoolOptions`](#pooloptions) - [`ThreadPoolOptions extends PoolOptions`](#threadpooloptions-extends-pooloptions) - [`ClusterPoolOptions extends PoolOptions`](#clusterpooloptions-extends-pooloptions) @@ -24,22 +28,22 @@ ### `pool = new FixedThreadPool/FixedClusterPool(numberOfThreads/numberOfWorkers, filePath, opts)` -`numberOfThreads/numberOfWorkers` (mandatory) Number of workers for this pool -`filePath` (mandatory) Path to a file with a worker implementation -`opts` (optional) An object with the pool options properties described below +`numberOfThreads/numberOfWorkers` (mandatory) Number of workers for this pool. +`filePath` (mandatory) Path to a file with a worker implementation. +`opts` (optional) An object with the pool options properties described below. ### `pool = new DynamicThreadPool/DynamicClusterPool(min, max, filePath, opts)` -`min` (mandatory) Same as _FixedThreadPool_/_FixedClusterPool_ numberOfThreads/numberOfWorkers, this number of workers will be always active +`min` (mandatory) Same as _FixedThreadPool_/_FixedClusterPool_ numberOfThreads/numberOfWorkers, this number of workers will be always active. `max` (mandatory) Max number of workers that this pool can contain, the newly created workers will die after a threshold (default is 1 minute, you can override it in your worker implementation). -`filePath` (mandatory) Path to a file with a worker implementation -`opts` (optional) An object with the pool options properties described below +`filePath` (mandatory) Path to a file with a worker implementation. +`opts` (optional) An object with the pool options properties described below. ### `pool.execute(data, name, transferList)` -`data` (optional) An object that you want to pass to your worker implementation +`data` (optional) An object that you want to pass to your worker implementation. `name` (optional) A string with the task function name that you want to execute on the worker. Default: `'default'` -`transferList` (optional) An array of transferable objects that you want to transfer to your [worker_threads](https://nodejs.org/api/worker_threads.html) worker implementation +`transferList` (optional) An array of transferable objects that you want to transfer to your [worker_threads](https://nodejs.org/api/worker_threads.html) worker implementation. This method is available on both pool implementations and returns a promise with the task function execution response. @@ -53,14 +57,33 @@ This method is available on both pool implementations and will call the terminat ### `pool.hasTaskFunction(name)` -`name` (mandatory) The task function name +`name` (mandatory) The task function name. This method is available on both pool implementations and returns a boolean. +### `pool.addTaskFunction(name, fn)` + +`name` (mandatory) The task function name. +`fn` (mandatory) The task function. + +This method is available on both pool implementations and returns a boolean promise. + +### `pool.removeTaskFunction(name)` + +`name` (mandatory) The task function name. + +This method is available on both pool implementations and returns a boolean promise. + ### `pool.listTaskFunctionNames()` This method is available on both pool implementations and returns an array of the task function names. +### `pool.setDefaultTaskFunction(name)` + +`name` (mandatory) The task function name. + +This method is available on both pool implementations and returns a boolean promise. + ### `PoolOptions` An object with these properties: @@ -132,7 +155,7 @@ An object with these properties: ### `class YourWorker extends ThreadWorker/ClusterWorker` -`taskFunctions` (mandatory) The task function or task functions object `{ name_1: fn_1, ..., name_n: fn_n }` that you want to execute on the worker +`taskFunctions` (mandatory) The task function or task functions object `{ name_1: fn_1, ..., name_n: fn_n }` that you want to execute on the worker. `opts` (optional) An object with these properties: - `killBehavior` (optional) - Dictates if your worker will be deleted in case a task is active on it. @@ -152,20 +175,20 @@ An object with these properties: #### `YourWorker.hasTaskFunction(name)` -`name` (mandatory) The task function name +`name` (mandatory) The task function name. This method is available on both worker implementations and returns `{ status: boolean, error?: Error }`. #### `YourWorker.addTaskFunction(name, fn)` -`name` (mandatory) The task function name -`fn` (mandatory) The task function +`name` (mandatory) The task function name. +`fn` (mandatory) The task function. This method is available on both worker implementations and returns `{ status: boolean, error?: Error }`. #### `YourWorker.removeTaskFunction(name)` -`name` (mandatory) The task function name +`name` (mandatory) The task function name. This method is available on both worker implementations and returns `{ status: boolean, error?: Error }`. @@ -175,6 +198,6 @@ This method is available on both worker implementations and returns an array of #### `YourWorker.setDefaultTaskFunction(name)` -`name` (mandatory) The task function name +`name` (mandatory) The task function name. This method is available on both worker implementations and returns `{ status: boolean, error?: Error }`.