git clone 'https://github.com/MarcoPolo/servant.git'
A Clojurescript library for interacting with webworkers sanely
add to your dependencies
Web workers are a pain to use, manage, and create, but they offer the ability of spawning real threads. This library seeks to give you the good parts, without any of the bad parts.
Through the magic of core.async's channels, we can abstract out a lot of the implementation details in webworkers. And with some careful execution, we can run the web workers in a similar context.
We create all our web workers at once and keep them on hand in a pool of available workers.
Any worker can run any function, so servants do not store any state.
We define functions that servants should be able to execute with
defservantfn. It is crucial that these functions be pure.
Under the hood,
defservantfn creates a normal function, but it also tells the webworker to remember this function.
(defservantfn some-random-fn [a b] (+ a b)) ;; This can also call other functions within the scope! (defn make-it-funny [not-funny] (str "Hahahah:" not-funny)) (defservantfn servant-with-humor [your-joke] (make-it-funny your-joke))
To make a call you need to wire up your servant by providing the servant-channel, a message sending fn, and your defined servant fn.
worker.postMessageis called. The simplest is defined in servant/standard-message.
(def result-channel (servant/servant-thread servant-channel servant/standard-message servant-fn 5 6))
This will call the servant-fn using a servant from the pool with the args 5 6.
This will return a channel that will contain the result. Similar to how core.async's thread works.
Web workers have a completely separate context from the main running script, so to be able to call functions freely, we use the same file for the main browser thread, and web workers. But doing that comes at a cost, you have to prevent the webworker from running code meant for the browser.
Our current solution is: ```clojure (defn window-load  ;; your browser specific code here )
(if (servant/webworker?) (worker/bootstrap) ;; Run the setup code for the web worker (set! (.-onload js/window) window-load) ;; run the browser specific code ) ```
Sometimes you want to have a separate cljs file for workers, and that's fine!
Nothing in this library prevents you from that.
Do the same thing you did before, but now this will run in a separate (possibly smaller) js file.
You simply need to figure out what's the best way to pass data around the main browser context, which is significantly easier because they share the context!
Simple example project
Encrypt/Decrypt Project using webworkers
I can't seem to figure out a good way to test web workers :(, I'd love to hear some ideas!
Copyright © 2013 Marco Munizaga
Distributed under the Eclipse Public License, the same as Clojure.