首页 > 代码库 > js库写法

js库写法

前言:

  现在javascript库特别多,其写法各式各样,总结几种我们经常见到的,作为自己知识的积累。而目前版本的 JavaScript 并未提供一种原生的、语言级别的模块化组织模式,而是将模块化的方法交由开发者来实现。因此,出现了很多种 JavaScript 模块化的实现方式,

以 AMD 为例,该规范使用 define 函数来定义模块。

define(factory(){    //模块化});

 

模块模式:

模块模式使用了 JavaScript 的一个特性,即闭包(Closures)。现今流行的一些 JS 库中经常见到以下形式的代码:

;(function (参数) {  // 模块代码  // return something;})(参数);

上面的代码定义了一个匿名函数,并立即调用自己。

也有一些开发者在函数表达式前面加上一个惊叹号(!)或分号(;),而不是用括号包起来。

!function (参数) {  // 代码  // return something}(参数);

还有些人喜欢用括号将整个 IIFE 围起来,这样就变成了以下的形式:

(function (参数) {  // 代码  // return something}(参数));

参数输入:

JavaScript 有一个特性叫做隐式全局变量(implied globals),当使用一个变量名时,JavaScript 解释器将反向遍历作用域链来查找变量的声明,如果没有找到,就假定该变量是全局变量。这种特性使得我们可以在闭包里随处引用全局变量,比如 jQuery 或 window。然而,这是一种不好的方式。

考虑模块的独立性和封装,对其它对象的引用应该通过参数来引入。如果模块内需要使用其它全局对象,应该将这些对象作为参数来显式引用它们,而非在模块内直 接引用这些对象的名字。以 jQuery 为例,若在参数中没有输入 jQuery 对象就在模块内直接引用 $ 这个对象,是有出错的可能的。正确的方式大致应该是这样的:

;(function ($, w) {  // $ is jQuery  // w is window  // 局部变量及代码  // 返回})(jQuery, window);

模块输出(Module Export)

有时我们不只是要使用全局变量,我们也要声明和输出模块中的对象,这可以通过匿名函数的 return 语句来达成,而这也构成了一个完整的模块模式。

var klm= (function () {    var myklm = {},        modeval= 1;     function privateMethod() {        // ...    }     myklm.moduleProperty = 1;    mymyklm.moduleMethod = function () {        // ...    };     return myklm ;}());

这段代码声明了一个变量 MODULE,它带有两个可访问的属性:moduleProperty 和 moduleMethod,其它的代码都封装在闭包中保持着私有状态。参考以前提过的参数输入,我们还可以通过参数引用其它全局变量。

输出简单对象:

使用对象直接量来表达 JavaScript 对象是很常见的。比如:var x = { p1: 1, p2: "2", f: function(){ /*... */ } }

var Module1 = (function () {  var private_variable = 1;  function private_method() { /*...*/ }   var my = {    property1: 1,    property2: private_variable,    method1: private_method,    method2: function () {        // ...    }  };  return my;}());

输出函数:

有时候我们希望返回的并不是一个对象,而是一个函数。有两种需求要求我们返回一个函数,一种情况是我们需要它是一个函数,比如 jQuery,它是一个函数而不是一个简单对象;另一种情况是我们需要的是一个“类”而不是一个直接量,之后我们可以用 "new" 来实例它。目前版本的 JavaScript 并没有专门的“类”定义,但它却可以通过 function 来表达。

var klm= (function () {  // 私有成员及代码 ...   return function(name) {    this.name = name;    this.bark = function() { /*...*/ }  };}()); var com = new klm("蒯灵敏");com.bark();

前面已经提到一种形式是输出对象直接量(Object Literal Notation),而 Revealing Module Pattern 其实就是这种形式,只是做了一些限定。这种模式要求在私有范围内中定义变量和函数,然后返回一个匿名对象,在该对象中指定要公开的成员。

var klm= (function () {  // 私有变量及函数  var x = 1;  function f1() {}  function f2() {}   return {    public_method1: f1,    public_method2: f2  };}());

扩展:

紧耦合扩展:

有时我们要求在扩展时调用以前已被定义的方法,这也有可能被用于覆盖已有的方法。这时,对模块的定义顺序是有要求的。

var klm = (function (my) {  var old_moduleMethod = my.moduleMethod;   my.moduleMethod = function () {    // 方法重载    // 可通过 old_moduleMethod 调用以前的方法...  };  return my;}(klm));

克隆与继承:

var MODULE_TWO = (function (old) {    var my = {},        key;     for (key in old) {        if (old.hasOwnProperty(key)) {            my[key] = old[key];        }    }     var super_moduleMethod = old.moduleMethod;    my.moduleMethod = function () {        // override method on the clone, access to super through super_moduleMethod    };     return my;}(MODULE));

上面代码再精简一下:可以使用 Object.create()

var MODULE_TWO = (function (old) {  var my = Object.create(old);   var super_moduleMethod = old.moduleMethod;  my.moduleMethod = function () {    // override method ...  };   return my;}(MODULE));

 与其它模块规范或 JS 库的适配:

模块环境探测:

现今,CommonJS Modules 与 AMD 有着广泛的应用,如果确定 AMD 的 define 是可用的,我们当然可以使用 define 来编写模块化的代码。然而,我们不能假定我们的代码必然运行于 AMD 环境下,有没有办法可以让我们的代码?

其实我们只需要在某个地方加上对 CommonJS Modules 与 AMD 的探测并根据探测结果来“注册”自己就可以了,以上那些模块模式仍然有用。AMD 定义了 define 函数,我们可以使用 typeof 探测该函数是否已定义。若要更严格一点,可以继续判断 define.amd 是否有定义。另外,SeaJS 也使用了 define 函数,但和 AMD 的 define 又不太一样。对于 CommonJS,可以检查 exports 或是 module.exports 是否有定义。

var klm = (function () {  var my = {};  // 代码 ...   if (typeof define == ‘function‘) {    define( function(){ return my; } );  }else if (typeof module != ‘undefined‘ && module.exports) {    module.exports = my;  }  return my;}());

其它一些 JS 库的做法

jquery的检测方式

if ( typeof module === "object" && module && typeof module.exports === "object" ) {    module.exports = jQuery;} else {    if ( typeof define === "function" && define.amd ) {        define( "jquery", [], function () { return jQuery; } );    }} if ( typeof window === "object" && typeof window.document === "object" ) {    window.jQuery = window.$ = jQuery;}

接下来看看多重匿名函数的做法:

(function (root, factory) {  if (typeof exports === "object" && exports) {    factory(exports); // CommonJS  } else {    var mustache = {};    factory(mustache);    if (typeof define === "function" && define.amd) {      define(mustache); // AMD    } else {      root.Mustache = mustache; // <script>    }  }}(this, function (mustache) {  // 模块主要的代码放在这儿});

这段代码与前面介绍的方式不太一样,它使用了两个匿名函数。后面那个函数可以看作是模块代码的工厂函数,它是模块的主体部分。前面那个函数对运行环境进行 检测,根据检测的结果对模块的工厂函数进行调用。另外,作为一个通用库,它并没使用 window 对象,而是使用了 this,因为在简单的函数调用中,this 其实就是全局对象。

再看看 doT 的做法

(function() {    "use strict";     var doT = {        version: ‘1.0.0‘,        templateSettings: { /*...*/ },        template: undefined, //fn, compile template        compile:  undefined  //fn, for express    };     if (typeof module !== ‘undefined‘ && module.exports) {        module.exports = doT;    } else if (typeof define === ‘function‘ && define.amd) {        define(function(){return doT;});    } else {        (function(){ return this || (0,eval)(‘this‘); }()).doT = doT;    }    // ...}());

这段代码里的 (0, eval)(‘this‘) 是一个小技巧,这个表达式用来得到 Global 对象,‘this‘ 其实是传递给 eval 的参数,但由于 eval 是经由 (0, eval) 这个表达式间接得到的,因此 eval 将会在全局对象作用域中查找 this,结果得到的是全局对象。若是代码运行于浏览器中,那么得到的其实是 window 对象。

 

JavaScript 模块化的未来

尚在制定中的 ES 6 会对模块作出语言级别的定义。我们来看一个实例,以下的代码段摘自“ES6:JavaScript中将会有的几个新东西”

module Car {   // 内部变量  var licensePlateNo = ‘556-343‘;   // 暴露到外部的变量和函数  export function drive(speed, direction) {     console.log(‘details:‘, speed, direction);   }   export module engine{     export function check() { }   }   export var miles = 5000;   export var color = ‘silver‘; };

在以后自己写js封装的时候上面是我参考的资料,继续激情的前进着。。。

js库写法