This repository is no longer being maintained. It was simply a proof-of-concept / experiment which required too much work to make decently usuable.
Please consider using Comlink instead.
Load a module in a new process, then use promises to interact with it.
This module is meant to require other Nodejs modules, but in a new process instead of the same process.
This is very new, experimental and features are still getting implemented.
There are many cases where this will not work with existing modules which accept data types, or return data types that are not yet implemented. Though this is being worked on. See the API.
Let's say you want to require a module, but the tasks it performs are synchronous and long, or simply does a lot of number crunching. That module would effect the performance and responsiveness of your application.
When using require-worker, that module would instead run in a different process, allowing your application to respond to incoming connections and do it's own number crunching at the same time, while still talking with that module in a similar way it used to.
I decided to create this module because simply creating a forked process and changing how you talk to the other code in the other process, can be cumbersome if your application is already quite complicated. Importing a module is easy. Most Nodejs applications require them to expand their functionality. Even modules themselves require other modules. So this module simply makes use of that ideology.
Nodejs 6.0 or greater is required. This project is written with ES6 features
Warning: This is currently not production-ready. Not all planned features are implemented yet.
Install the module via NPM
npm install require-worker --save
Or download the latest release, or git clone the repository on GitHub.
See the API for more information.
// Require require-worker
const requireWorker = require('require-worker');
// Example Using Async Await
(async ()=>{
// Require native nodejs OS module (return proxy)
const os = requireWorker.require('os');
// Proxy call userInfo()
var { value:userInfo } = await os.userInfo();
// Output result
console.log(userInfo);
// Stop require-worker
await os.constructor.client.destroy();
})();View results on Travis-CI, or run tests manually:
Install development dependencies for this module: npm install
Then run the test npm script: npm test
Since this module spawns child processors, some test results may take a while to complete.
Tests are written with ES6 features just like this module.
Create issues or pull requests on the GitHub project.
All the help is appreciated.
MIT License
Copyright (c) 2018 Jason Sheppard @ https://github.com/Jashepp
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Github Repository: https://github.com/Jashepp/require-worker
NPM Package: https://npmjs.org/package/require-worker