lazy-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.

Lazy 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.

NPM

  • Use: require('lazy-require')
  • Install: npm install --save lazy-require
// 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 
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(errambi){
    // 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('ambi', {/* options */}, function(errambi){
    // 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(errambi){
    // Error ... 
    if (err)  return console.log('ambi failed to load because of:', err.stack)
 
    // Success ... 
})

The following options are supported:

  • cwd the module path that you would like the requested package to be installed to if it doesn't exist, always recommended
  • save if the requested package doesn't exist, would you like to do a npm --save for it to add it to your cwd's package.json dependencies?

There's some other methods also available to you, for now, read the source to discover them.

Discover the change history by heading on over to the HISTORY.md file.

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

These amazing people are maintaining this project:

  • Benjamin Lupton b@lupton.cc (https://github.com/balupton)

No sponsors yet! Will you be the first?

These amazing people have contributed code to this project:

Become a contributor!

Unless stated otherwise all works are:

  • Copyright © 2013+ Bevry Pty Ltd us@bevry.me (http://bevry.me)

and licensed under: