Feature/add workerize utility

browser/src/Workerize.ts

@@ -0,0 +1,35 @@
+interface IArgs<T> {
+ data: T
+}
+
+type Callback<T> = (args?: T) => any
+
+/**
+ * Takes a CPU intensive function
+ * passes it off to a dynamically generated WebWorker
+ * and returns a promise to resolve the return value of the function
+ *
+ * limitations: function has to be Pure! -> no external dependencies etc.
+ * @name workerize
+ * @function
+ * @param Callback<T>
+ * @param args?: T
+ * @returns Promise<R>
+ */
+export function workerize<T, R>(work: Callback<T>, args?: T) {
+ const handleResult = ({ data }: IArgs<T>) => {
+ const result = work(data)
+ const webWorker: Worker = self as any
+ return webWorker.postMessage(result)
+ }
+
+ // courtesy of this gem -
+ // https://stackoverflow.com/questions/42773714/is-async-await-truly-non-blocking-in-the-browser
+ // writes the contents of the string passed in to a file and executes it.
+ const blob = new Blob([`var work = ${work};\n onmessage = ${handleResult.toString()}`], {
+ type: "text/javascript",
+ })
+ const worker = new Worker(URL.createObjectURL(blob))
+ worker.postMessage(args)
+ return new Promise<R>(resolve => (worker.onmessage = evt => resolve(evt.data)))
+}