SideWorker is a minimal JavaScript library to make using Web Workers as painless as possible.
It has been based on the WorkerB library by Luke Schaefer.
The main purpose of SideWorker is NOT having to create a seperate file for code that is run in a different thread. The Web Workers can be created inline to the main code and be communicated with asynchronously.
The idea is to consolidate the seperate script and the logic to interact with that script into one JS object.
SideWorker has no dependencies. You can install it via NPM:
npm install @79nine/SideWorker
and then use it in your code:
import SideWorker from '@78nine/sideworker' // ES Module style
// or
const SideWorker = require('@78nine/sideworker') // Node style
Another option is to simply include the minified file in your project (e.g. through the UnPKG):
<script src='https://unpkg.com/@78nine/sideworker'></script>
This option will expose a global SideWorker
variable available on you web page.
// Create a new, empty SideWorker
const worker = new SideWorker();
// Define a method that will be run later in your code. This method needs:
// A name -> 'countToX'
// A function it will perform
worker.define('countToX', (x) => {
for(let i = 0; i < x; i++) {
continue;
}
return i;
}
// Use the defined method where you need it, and handle it's result via Promise:
worker.run.countToX(42).then((res) => console.log('X is', res));
// or with async/await syntax
const res = await worker.run.countToX(128);
console.log('Now the X is', res);
// The method's operation is non-blocking and performed in a seperate thread.
When creating an instance of the SideWorker you can pass it and object with two options:
Default: false
If the debug
option will be set to true
the SideWorker will give you some additional information about it's work inside the browser's console.
const worker = new SideWorker({ debug: true });
Default: undefined
The init
option can be used to pass a function, which then will be automatically called upon the Web Worker's creation.
This can be very useful for instance to importScripts()
and define worker-scoped variables or function needed later.
const worker = new SideWorker({
init: () => {
importScripts('https://unpkg.com/[email protected]/dist/faker.min.js');
self.someGlobalFunction = () => {
// do something
}
}
});
// and then inside another method:
worker.define('doSomething', () => {
// `faker` is a globally available variable
// `someGlobalFunction()` is a globally available function
});
It is also possible to pass additional arguments to the init function that are available in your main script's scope:
const answer = 42;
const persona = {
firstName: 'Arthur',
lastName: 'Dent'
}
const worker = new SideWorker({
init: (num, obj) => {
self.answer = num; // the `num` value is `42`
self.him = obj; // the `obj` value is `{ firstName: 'Arthur', lastName: 'Dent' }`
}
}, answer, persona);
Note: examples of all the basic functionality can be also explored in the examples folder.