node package manager

ym

Async modular system

Modular system

по-русски

What? Why and what for? How to use? (ru)

  1. Asynchronous require for modules
  2. Asynchronous provide for modules
  3. Extending and redefining a module

See #1, #2 and #3 in the list of requirements.

See #2 and #3 in the list of requirements.

void modules.define(
    String moduleName,
    [String[] dependencies],
    Function(
        Function([Object objectToProvide], [Error error]) provide,
        [Object resolvedDependency, ...],
        [Object previousDeclaration]
    ) declarationFunction
)
void modules.require(
    String[] dependencies,
    Function([Object resolvedDependency, ...]) successCallbackFunction,
    [Function(Error error) errorCallbackFunction]
)
void setOptions(Object options)
  • trackCircularDependencies - if set to false doesn't track circular dependencies. true by default
  • allowMultipleDeclarations - if set to false denies module overloading and provides an error. true by default
String getState(String name)
  • NOT_DEFINED - module wasn't defined
  • NOT_RESOLVED - module was defined, but it hasn't started resolving
  • IN_RESOLVING - resolving is in progress
  • RESOLVED - module is already resolved
Boolean isDefined(String moduleName)
Modules modules.create()
modules.define(
    'A',
    ['B', 'C'],
    function(provide, b, c, prev) {
        var a = {};
        provide(a);
    });
 
modules.define(
    'B',
    function(provide) {
        var b = {};
        provide(b);
    });
 
modules.define(
    'C',
    ['B'],
    function(provide, b) {
        var c = {};
        provide(c);
    });
 
modules.define(
    'C',
    function(provide, prevC) {
        var nextC = {};
        provide(nextC);
    });
 
modules.require(
  ['A'],
  function(a) {
    // module 'A' now resolved to a 
  });