Prevent files and modules being required more than once. Helps with auto-reloaders or test runners that insist.
Require Guard is a library for Node.js that prevents files from being required and loaded more than once.
When you find yourself fighting code-reloaders or test runners like Mocha to stop reloading your slow initialization code each cycle, and no one else can help, maybe you can hire the Require Guard.
"Hey, but doesn't Node.js'
require itself not require files twice?"
Yes, but those pesky code-reloaders and test runners, for your own good, unload everything between [test] cycles to keep things fresh. For such cases Require Guard is the sliced bread beneath your toast. Run that external process or slow op once and not worry that it gets run again.
npm install require-guard
Then you have 3 ways:
Prevent the current file from being reloaded:require"require-guard"
Prevent an already loaded library (also takes an array) from being reloaded:require"selenium-webdriver"require"require-guard""selenium-webdriver"
Prevent an already loaded file (also takes an array) from being reloaded:require"./start-browser"require"require-guard""./start-browser"
As an example, let's say you're using Mocha with Selenium WebDriver. Because Selenium starts up as fast as an old Lada engine, you'll want to boot it up once when starting Mocha's watcher and then get on your merry way with testing.
require"require-guard"var WebDriver = require"selenium-webdriver"moduleexports = build
var browser = require"./browser"describe"The Internet"
mocha --watch reruns and reruns your tests, your browser will remain open and will get reused.
Require Guard is released under a Lesser GNU Affero General Public License, which in summary means:
- You can use this program for no cost.
- You can use this program for both personal and commercial reasons.
- You do not have to share your own program's code which uses this program.
- You have to share modifications (e.g bug-fixes) you've made to this program.
For more convoluted language, see the
If you find Require Guard has muscles that need improving, please type to me at email@example.com or create an issue.