thingamajig
v0.0.1
Published
live editing for node.js and the browser
Downloads
4
Maintainers
caspervonbReadme
Thingamajig.js - Live Editing for Node.js and Browsers
Thingamajig.js is a small runtime extension that enables live-editing of scripts as-well as live-reloading of required json files.
It's a pure, self-contained JavaScript based implementation with no external parts and should work in any more or less any JavaScript runtime, be it Node.js, Chrome, Firefox, Safari, Internet Explorer or Microsoft Edge.
Features
Live Editing of Scripts
Whenever scripts are changed on disk, across the network or within the document object model itself (e.g inline script tags) the source of that script is re-evaluated in its original execution context.
Re-evaluation means the following things:
- Modified and new top level call expressions are called.
- Surviving call expressions yield their previous value.
- Function modifications are applied.
Live Reloading of JSON
Whenever the source of a JSON file changes on disk that has been imported with
require, it will reload and replace the key/value pairs on the original
object.
This only applies to Node.js environments.
Getting Started
Live.js has been designed to be as configuration free as possible, just include the script in your program and be done with it.
Node.js
- Install the
thingamajigmodule.
npm install thingamajig- Start node with the
--require(shorthand-r) option, passing inthingamajigas the module name to require.
node -r thingamajig myapp.js- Enjoy live editing and reloading.
Browser
- Include the following script at the very top of the
headsection in your document.
<script type="text/javascript">
window.stop();
document.write('<script src="thingamajig.js"><\/script><body><\/body>'));
</script>Open the document in your preferred browser.
Enjoy live editing and reloading.
License
MIT