全文来自common.js的wiki里面的关于Modules/Wrappings的那篇,只是简单翻译翻译。
----------------------------------------------------------------------------------------------------
状况:建议(proposal)
已经实现的:FlyScript SeaJS
本文主要讲模块被formatted,为了在使用上下文(contexts)-----在模块内容被执行的时候,在模块加载器可能不能提供内含的模块scope
契约(contract):
- 在模块里,一个自由的变量 module 一定有一个属性declare----它是一个方法
- declare方法接受一个单一的参数,模块factory
- 模块factory一定是方法或者一个对象
- 模块factory是一个方法
- 方法的3个参数,如果被指定,一定是require,exports,module,以这样的顺序。
- 当方法被调用的时候,需要模块的exports的初始化
- 如果方法返回一个值,模块的exports来设置这个值
- 如果模块factory是一个对象,模块的exports是设置那个对象的
一个基本的包裹的模块
module.declare(function(require,exports,module){ exports.foo = "bar"; });
一个被包裹的模块带有返回值
module.declare(function(require){ return {foo:"bar"}; });
一个被包裹的模块带有一个对象factory
module.declare({ foo:"bar" });
扩展阅读:
http://wiki.commonjs.org/wiki/Modules/Wrappings