bevryLazy Require
Lazy require allows you to require modules lazily, meaning that when you lazy require a module that is missing, lazy require will automatically install it for you.
Usage
// Import
var lazyRequire = require('lazy-require')
// Attempt to load the module `ambi`, if it doesn't exist, then try to install it and load it again
// Do this synchronously, only available in Node 0.12 and above
// Passing a callback as the 3rd argument will do this asynchronously, available in all node versions
var ambi = lazyRequire('ambi', {
/* options */
})
if (ambi instanceof Error) {
// Error ....
console.log('ambi failed to load because of:', ambi.stack)
} else {
// Success ...
}
// Attempt to load the module `ambi`, if it doesn't exist, then try to install it and load it again
// Do this synchronously but with a callback, only available in Node 0.12 and above
lazyRequire.sync(
'ambi',
{
/* options */
},
function (err, ambi) {
// Error ...
if (err)
return console.log('ambi failed to load because of:', err.stack)
// Success ...
}
)
// Attempt to load the module `ambi`, if it doesn't exist, then try to install it and load it again
// Do this asynchronously, available in all node versions
lazyRequire.async(
'ambi',
{
/* options */
},
function (err, ambi) {
// Error ...
if (err)
return console.log('ambi failed to load because of:', err.stack)
// Success ...
}
)
// Attempt to load the module `ambi`, if it doesn't exist, then try to install it and load it again
// Do this synchronously if supported (Node 0.12 and above), otherwise do it asynchronously
lazyRequire.auto(
'ambi',
{
/* options */
},
function (err, ambi) {
// Error ...
if (err)
return console.log('ambi failed to load because of:', err.stack)
// Success ...
}
)The following options are supported:
cwdthe module path that you would like the requested package to be installed to if it doesn't exist, always recommendedsaveif the requested package doesn't exist, would you like to do anpm --savefor it to add it to yourcwd'spackage.jsondependencies?
There's some other methods also available to you, for now, read the source to discover them.
Install
npm
- Install:
npm install --save lazy-require - Import:
import * as pkg from ('lazy-require') - Require:
const pkg = require('lazy-require')
jspm
<script type="module">
import * as pkg from '//dev.jspm.io/lazy-require@4.6.0'
</script>Editions
This package is published with the following editions:
lazy-requirealiaseslazy-require/source/index.jslazy-require/source/index.jsis ESNext source code for Node.js with Require for moduleslazy-require/edition-browsers/index.jsis ESNext compiled for web browsers with Require for modules
History
Discover the release history by heading on over to the HISTORY.md file.
Contribute
Discover how you can contribute by heading on over to the CONTRIBUTING.md file.
Backers
Maintainers
These amazing people are maintaining this project:
Sponsors
No sponsors yet! Will you be the first?
Contributors
These amazing people have contributed code to this project:
Discover how you can contribute by heading on over to the CONTRIBUTING.md file.
License
Unless stated otherwise all works are:
- Copyright © 2013+ Bevry Pty Ltd
and licensed under: