翻译一下Modules/Wrappings规范

全文来自common.js的wiki里面的关于Modules/Wrappings的那篇，只是简单翻译翻译。

 

----------------------------------------------------------------------------------------------------

 

状况：建议(proposal)

 

已经实现的：FlyScript  SeaJS

 

   本文主要讲模块被formatted，为了在使用上下文（contexts）-----在模块内容被执行的时候，在模块加载器可能不能提供内含的模块scope

 

 

 

 

契约（contract）：

 

• 在模块里，一个自由的变量 module 一定有一个属性declare----它是一个方法
• declare方法接受一个单一的参数，模块factory
• 模块factory一定是方法或者一个对象
• 模块factory是一个方法

1. 方法的3个参数，如果被指定，一定是require，exports，module，以这样的顺序。
2. 当方法被调用的时候，需要模块的exports的初始化
3. 如果方法返回一个值，模块的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