What? Why and what for? How to use? (ru)
####Requirements####
- Asynchronous require for modules
- Asynchronous provide for modules
- Extending and redefining a module
####Why not CommonJS?#### See #1, #2 and #3 in the list of requirements.
####Why not AMD?#### See #2 and #3 in the list of requirements.
####Module declaration####
void modules.define(
String moduleName,
[String[] dependencies],
Function(
Function([Object objectToProvide], [Error error]) provide,
[Object resolvedDependency, ...],
[Object previousDeclaration]
) declarationFunction
)####Module usage####
void modules.require(
String[] dependencies,
Function([Object resolvedDependency, ...]) successCallbackFunction,
[Function(Error error) errorCallbackFunction]
)####Modules storage configuration####
void setOptions(Object options)#####Available options#####
trackCircularDependencies- if set to false doesn't track circular dependencies. true by defaultallowMultipleDeclarations- if set to false denies module overloading and provides an error. true by default
####Get current state of module in storage####
String getState(String name)#####Possible states#####
NOT_DEFINED- module wasn't definedNOT_RESOLVED- module was defined, but it hasn't started resolvingIN_RESOLVING- resolving is in progressRESOLVED- module is already resolved
####Check for module existence in storage####
Boolean isDefined(String moduleName)####Create yet another modules storage####
Modules modules.create()####Example####
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
});