Run arbitrary JavaScript code as jobs, in a browser-based sandbox.
Especially designed for medium to large-sized computations with no or limited access to external services, which does not need to syncronize with other computations. Persistence of data is handled outside the job itself. This architecture makes for services which are easy to distribute and scale.
Usecases include
- Having 'plugins' for a backend/service with well-defined interface and isolation. Independent deploys and faster change-around times, without having to build a microservice. Possibility of allowing 3rd-party extensions.
- Peer-to-peer distributed processing, across both servers and browsers.
- Sandboxed execution of native (C/C++ etc) code, by compiling to JS via Emscripten or similar.
- Building compute-heavy services, including backend, in a frontend/browser-first manner.
In production
- PhantomJS 2.0 (recommended) and PhantomJS 1.x supported
- Code used in production at The Grid since March 2015
- Support for SlimerJS/Gecko and WebDriver
- WebWorker and client-side runner support
- noflo-jsjob makes it easy to use JsJob in NoFlo applications, and create distributed workers over AMQP/RabbitMQ or MQTT when combined with noflo-msgflo.
- jsjob-ethereum is an experiement for a decentralized computation market using the Ethereum blockchain.
- ... Let us know about your project, and we'll link it here!
Get it from NPM
npm install --save jsjob
Install PhantomJS 2.x (recommended), either from upstream or using your OS package manager.
http://phantomjs.org/download.html
Alternatively, get PhantomJS 1.x from NPM
npm install --save phantomjs
Solver code | JsJob plugin | Input format
echo '{"board":".94...13..............76..2.8..1.....32.........2...6.....5.4.......8..7..63.4..8"}' | jsjob-run https://flowhub.github.io/jsjob/examples/sudoku.js
A JsJob needs to implement a single function, window.jsJobRun:
window.jsJobRun = function(inputdata, options, callback) {
var err = null;
var result = {'hello': 'jsjob'};
var details = {'meta': 'data'}; // Can be used for information about the execution or results
return callback(err, result, details);
};
This should be bundled into a self-contained (no external dependencies) .js bundle.
For non-trivial code, we recommend using NPM modules for dependencies, and building with
Webpack or Browserify.
Serve the .js file from a HTTP file-server, which the runner has access to.
Locally you can use simple-server from NPM.
For publically accessible URL, you can use Github Pages, Amazon S3 or similar.
When deploying to a public server, use SSL/HTTPS!
var jsjob = require('jsjob');
var options = {};
var runner = new jsjob.Runner(options);
runner.start(function(err) {
var pluginUrl = 'https://example.net/myjsjob.js'; // Something implementing JsJob API
var inputData = {'bar': "baz"};
var jobOptions = {};
runner.runJob(pluginUrl, inputData, jobOptions, function(err, result, details) {
console.log('jsjob returned', err, result, details);
runner.stop(function(err) { }); // one can have many runJob() calls for a single runner
});
});
Basic example
echo '{"input": "sss"}' | jsjob-run http:/localhost:8001/spec/fixtures/jsjobs/return-input.js
Will execute the .js file in browser sandbox with the given data, and then writes result (or error) to the console.
{"input": "sss"}
Supported options
Usage: jsjob-run [options] <job.js>
Options:
-h, --help output usage information
--port <portnumber> Port to use for Runner HTTP server
--timeout <seconds> Number of seconds to limit job to
--verbose [enable] Verbose, logs console of job execution
--joboptions <json> Options to provide the job, as second argument of jsJobRun()
--script <code> JavaScript code injected before jsjob.js. Used for polyfills or API adapters
For an up-to-date list, use jsjob-run --help
git clone [email protected]:flowhub/jsjob.git
Run the tests
npm test
Check the existing list first.
Fork and submit on Github
# change version in package.json
git tag 1.x.y
git push origin HEAD:master --tags
# wait for Travis CI to do the rest