读RequireJS — Module

Module 即模块，来看下RequireJS怎么定义 Module :

1. 简单的名值对

// Inside file my/shirt.js:
define({
    color: "black",
    size: "unisize"
});

2. 定义成一个Function

// my/shirt.js now does setup work
// before returning its module definition.
define(function () {
    // Do setup work here
 
    return {
        color: "black",
        size: "unisize"
    }
});

3. 如果 Module 需要依赖别的模块，可以写成这样：

// my/shirt.js now has some dependencies, a cart and inventory
// module in the same directory as shirt.js
define(["./cart", "./inventory"], function(cart, inventory) {
        // return an object to define the "my/shirt" module.
        return {
            color: "blue",
            size: "large",
            addToCart: function() {
                inventory.decrement(this);
                cart.add(this);
            }
        }
    }
);

4. 隐式依赖Function

define(function(require) {
    var mod = require("./relative/name");
});

上面这四种比较常用，RequireJS 中的 Module 还有其他的形式，具体可参阅官方文档。

上面四种方式都用到了define()，接下来我们就来看下define的源码：

/**
 * The function that handles definitions of modules. Differs from
 * require() in that a string for the module should be the first argument,
 * and the function to execute after dependencies are loaded should
 * return a value to define the module corresponding to the first argument's
 * name.
 */
define = function (name, deps, callback) {
    var node, context;
 
    // 可以是匿名模块
    if (typeof name !== 'string') {
        // 调整参数
        callback = deps;
        deps = name;
        name = null;
    }
 
    // 如果模块没有依赖
    if (!isArray(deps)) {
        callback = deps;
        deps = [];
    }
 
    // 如果是一个没有传入依赖的Function，即例4所示
    if (!deps.length && isFunction(callback)) {
        // 通过 callback.toString() 找依赖
        // 为了避免 require(xx) 写在注释中
        // 这里先把注释都去掉，再把require的东东加入deps数组
        // 
        // 很变态的一点就是如果callback里写了require
        // 则 callback 必须有形参，不然会被无视
        if (callback.length) {
            callback
                .toString()
                .replace(commentRegExp, "")
                .replace(cjsRequireRegExp, function (match, dep) {
                    deps.push(dep);
                });
 
            //May be a CommonJS thing even without require calls, but still
            //could use exports, and module. Avoid doing exports and module
            //work though if it just needs require.
            //REQUIRES the function to expect the CommonJS variables in the
            //order listed below.
            // 可能某些模块即使没有调用require，但却仍然要用到exports和module
            // 如果模块仅仅需要require，就应该避免exports和module的开销
            // 注意：依赖的顺序应该确保像下面这样
            //
            // 这里我把中英文都给出了，因为对于这句我一直很疑惑
            // 1个形参 需要 require
            // 大于1个形参 需要 require exports module
            // 1和非1有那么大差别么，请高手指点一下，这句实在很无解
            deps = (callback.length === 1 ? ["require"] : ["require", "exports", "module"]).concat(deps);
        }
    }
 
    // 应用场景：IE6-8，并且是定义一个匿名模块
    // 个人觉得这个判断没有意义，请看下面的注释
    if (useInteractive) {
        node = currentlyAddingScript || getInteractiveScript();
        if (node) {
            if (!name) {
                name = node.getAttribute("data-requiremodule");
            }
            context = contexts[node.getAttribute("data-requirecontext")];
        }
    }
 
    // 真正定义模块的操作放到script onload函数中执行，有两个好处：
    // 1.如果一个文件定义了多个模块，这样可以防止过早的分析依赖, 而是等拿到所有依赖之后, 统一进行处理
    // 2.如果是定义匿名模块, define执行中我们是不知道 moduleName的, 但在onload函数中却可以知道
    //
    // 这里有个问题，即下面这行代码表示有context就加入context.defQueue，没有就加入globalDefQueue
    // 很明显，context有值的情况仅在IE6-8会出现，
    // 而在onload时，会把globalDefQueue里的东西全部加入context.defQueue，所以加入谁无所谓
    // 而且在onload函数中所有浏览器都可以拿到moduleName，所以下面这句和上面那个if判断都失去意义了
    // 可以写成 globalDefQueue.push([name, deps, callback]);
    (context ? context.defQueue : globalDefQueue).push([name, deps, callback]);
 
    return undefined;
};

define() 有三个参数，不传 name 参数表示为匿名模块，匿名只是写法上的匿名，RequireJS 可以通过文件路径确定 moduleName，所以最好别传 name 参数，这样文件目录即使有变动，也不会影响模块的正常使用。

这里 callback 参数命名很不好，一般都会叫做factory，取名 callback 完全不知所云。

所谓的 define 是干嘛的呢 ?

这个函数用于定义模块，可具名，也可匿名，可有依赖，也可无依赖，factory可以是一个function，也可以是一个object，define 就是为当前的模块绑定一个 factory，当我们要用这个模块的时候，再通过 factory 把它造出来。当然，factory是个object，就不需要再造了。

可以看到模块不是单独存在的，一般都会依赖别的模块，我们知道，在web开发中，如果要加载一个资源，都需要在回调函数中进行处理，因为加载是异步的。

而 CommonJS 想实现同步加载的概念，所以每次加载一个模块，会首先把依赖分析出来，加载完依赖之后，再去执行factory，这样倒也算是一种模拟同步了。