|
||
---|---|---|
.github/workflows | ||
__test__ | ||
.gitignore | ||
bun.lockb | ||
index.js | ||
jsr.json | ||
LICENSE | ||
mod.ts | ||
offload.error.ts | ||
offload.handler.ts | ||
offload.interface.ts | ||
offload.ts | ||
package.json | ||
README.md | ||
tsconfig.json |
Offload
Offload heavy tasks using WebWorkers.
Offload creates a limited execution pool and can operate in two modes:
- callback mode (default) - spawns web workers on demand when the function is called, self terminated
- background - runs workers as backround jobs, distributes load among them, must be terminated manually
Currently uses unstable WebWorkers API.
Install:
bun add githib:nesterow/offload # or pnpm
Usage
Considering following worker:
// print.worker.ts
import { handler } from "@nesterow/offload";
declare var self: Worker;
handler(async (data: string) => {
await new Promise((resolve) => setTimeout(resolve, 1000));
console.log(data);
return true;
});
Callback operation mode
In the callback mode, print()
will spawn a worker and terminate it after the task is done.
Maximum of 5 workers may be spawned at the same time, the rest will be queued:
import { offload } from "@nesterow/offload";
const [print, terminate] = offload<boolean, string>("./print.worker.ts", 5);
await print("Hello, World!"); // => true
Callback operatinal mode us useful when thread startup delay doesn't matter.
You don't need to worry about worker termination as it exits after the callback returns result.
This is default "safe" option as it allows to call offload
in any part of the application.
Background operation mode
In the background mode, offload will spawn 5 workers, print()
will distribute the tasks among them:
import { offload } from "@nesterow/offload";
const [print, terminate] = offload<boolean, string>("./print.worker.ts", 5, 'bg');
await print("Hello, World!"); // => true
terminate(); // terminate all workers, for example on exit signal
Background operation mode is useful when you need to spawn pre-defined number of the threads on application start. Generally it is more effective as it balances the load among the threads and doesn't have startup delay.
Types
Because offload doesn't know params and return types of your worker, you need to pass type arguments manually:
const [callback, termiate] = offload<ReturnType, ParamType>("./my.worker.ts", 1);
const param: ParamType = {};
const result: ReturnType = await callback(param: ParamType);
License
MIT