JavaScriptモジュール式プログラミング(再版)、JavaScriptモジュール化

JavaScriptモジュール式プログラミング著者：Ruan Yifeng 公開時間：2013-01-08 18:04 閲覧数：7632 回お勧め数：40 オリジナルリンク [コレクション]

JavaScript モジュール化プログラミング (再版)、JavaScript モジュール化_PHP チュートリアル関数 m1(){ //... } 関数 m2(){ //... }

上記の関数 m1() と m2() はモジュールを構成します。使用する場合は直接呼び出してください。

このアプローチの欠点は明らかです。グローバル変数を「汚染」し、変数名が他のモジュールと競合しないという保証がなく、モジュールのメンバー間に直接の関係がありません。

2. オブジェクトの書き方

上記の欠点を解決するために、モジュールをオブジェクトとして記述し、すべてのモジュールのメンバーをこのオブジェクトに配置することができます。

リーリー

上記の関数 m1() と m2() は module1 オブジェクトにカプセル化されています。使用するときは、このオブジェクトのプロパティを呼び出すだけです:

リーリー

ただし、この書き方ではモジュールのメンバーがすべて公開されてしまい、内部状態を外部から書き換えることができます。たとえば、外部コードは内部カウンターの値を直接変更できます。

リーリーリーリー

3.即時実行関数の書き方

「即時呼び出し関数式」(IIFE) を使用すると、プライベートメンバーを公開しないという目的を達成できます。

リーリー

上記の書き方では、外部コードは内部の_count変数を読み込むことができません。

リーリー

Module1はJavaScriptモジュールの基本的な書き方です。次に、この書き込みメソッドを処理していきます。

4. ズームインモード

モジュールが大きくていくつかの部分に分割する必要がある場合、またはあるモジュールが別のモジュールを継承する必要がある場合は、「拡張」を使用する必要があります。

リーリー

上記のコードは、新しいメソッド m3() を module1 モジュールに追加し、新しい module1 モジュールを返します。

5.緩い拡張モード

ブラウザ環境では、通常、モジュールのさまざまな部分がインターネットから取得され、どの部分が最初に読み込まれるかがわからない場合があります。前節の書き込み方法を使用すると、最初に実行される部分で存在しない空のオブジェクトが読み込まれる可能性があり、その場合は「拡張モード」を使用する必要があります。

リーリー

「拡大モード」と比較して、「ワイド拡大モード」は「即時実行関数」のパラメータを空のオブジェクトにすることができることを意味します。

6. グローバル変数を入力します

独立性はモジュールの重要な機能です。モジュール内のプログラムの他の部分と直接対話しないことが最善です。

モジュール内でグローバル変数を呼び出すには、他の変数を明示的にモジュールに入力する必要があります。

リーリー

上記の module1 モジュールは jQuery ライブラリと YUI ライブラリを使用する必要があるため、これら 2 つのライブラリ (実際には 2 つのモジュール) がパラメータとして module1 に入力されます。これにより、モジュールの独立性が確保されるだけでなく、モジュール間の依存関係も明確になります。この点に関する詳細な議論については、Ben Cherry の有名な記事「JavaScript モジュールパターン: 詳細」を参照してください。

JavaScript モジュール化プログラミング (再版)、JavaScript モジュール化_PHP チュートリアル var math = require ('math'); その後、モジュールが提供するメソッドを呼び出すことができます:

リーリー

このシリーズは主にブラウザプログラミングを目的としており、node.js については触れないため、CommonJS についてはあまり紹介しません。ここで知っておく必要があるのは、モジュールをロードするために require() が使用されるということだけです。

9.ブラウザ環境

サーバー側モジュールの場合、当然、誰もがクライアント側モジュールを望んでいます。そして、この 2 つに互換性があり、モジュールを変更せずにサーバーとブラウザの両方で実行できることが最善です。

ただし、大きな制限があるため、CommonJS仕様はブラウザ環境には適していません。前のセクションのコードをブラウザで実行すると、依然として大きな問題が発生することがわかりますか?

リーリー

2行目Math.add(2,3)は1行目のrequire('math')の後に実行されるので、math.jsが読み込まれるまで待つ必要があります。つまり、読み込みに時間がかかると、アプリ全体がハングアップして待機することになります。

すべてのモジュールはローカルのハードディスクに保存されており、同期してロードできるため、これはサーバー側の問題ではありません。待機時間はハードディスクの読み取り時間です。ただし、ブラウザにとってこれは大きな問題です。モジュールはサーバー側に配置され、待ち時間はネットワークの速度に依存するため、時間がかかる場合があり、ブラウザは「一時停止」状態になります。。

そのため、ブラウザ側モジュールは「同期読み込み」(同期)は使えず、「非同期読み込み」(非同期)しか使えません。これが AMD 仕様が生まれた背景です。

十、AMD

AMDとは「Asynchronous Module Definition」の略で、「非同期モジュール定義」という意味です。モジュールは非同期でロードされ、モジュールのロードは後続のステートメントの実行には影響しません。このモジュールに依存するすべてのステートメントは、コールバック関数で定義されます。このコールバック関数は、読み込みが完了するまで実行されません。

　　AMD 也采用 require ()语句加载模块，但是不同于 CommonJS，它要求两个参数：

require ([module], callback);

ログイン後にコピー

　　第一个参数[module]，是一个数组，里面的成员就是要加载的模块；第二个参数 callback，则是加载成功之后的回调函数。如果将前面的代码改写成 AMD 形式，就是下面这样：

require (['math'], function (math) {
    math.add (2, 3);
});

ログイン後にコピー

　　math.add () 与 math 模块加载不是同步的，浏览器不会发生假死。所以很显然，AMD 比较适合浏览器环境。

　　目前，主要有两个 Javascript 库实现了 AMD 规范：require.js 和 curl.js。本系列的第三部分，将通过介绍 require.js，进一步讲解 AMD 的用法，以及如何将模块化编程投入实战。

　　我采用的是一个非常流行的库 require.js。

　　一、为什么要用 require.js？

　　最早的时候，所有 Javascript 代码都写在一个文件里面，只要加载这一个文件就够了。后来，代码越来越多，一个文件不够了，必须分成多个文件，依次加载。下面的网页代码，相信很多人都见过。

<script src="1.js"></script>
<script src="2.js"></script>
<script src="3.js"></script>
<script src="4.js"></script>
<script src="5.js"></script>
<script src="6.js"></script>

ログイン後にコピー

　　这段代码依次加载多个 js 文件。

　　这样的写法有很大的缺点。首先，加载的时候，浏览器会停止网页渲染，加载文件越多，网页失去响应的时间就会越长；其次，由于 js 文件之间存在依赖关系，因此必须严格保证加载顺序（比如上例的1.js 要在2.js 的前面），依赖性最大的模块一定要放到最后加载，当依赖关系很复杂的时候，代码的编写和维护都会变得困难。

　　require.js 的诞生，就是为了解决这两个问题：

<p>（1）实现 js 文件的异步加载，避免网页失去响应；</p>
<p>（2）管理模块之间的依赖性，便于代码的编写和维护。</p>

ログイン後にコピー

　　二、require.js 的加载

　　使用 require.js 的第一步，是先去官方网站下载最新版本。

　　下载后，假定把它放在 js 子目录下面，就可以加载了。

<script src="js/require.js"></script>

ログイン後にコピー

　　有人可能会想到，加载这个文件，也可能造成网页失去响应。解决办法有两个，一个是把它放在网页底部加载，另一个是写成下面这样：

<script src="js/require.js" defer async="true" ></script>

ログイン後にコピー

　　async 属性表明这个文件需要异步加载，避免网页失去响应。IE 不支持这个属性，只支持 defer，所以把 defer 也写上。

　　加载 require.js 以后，下一步就要加载我们自己的代码了。假定我们自己的代码文件是 main.js，也放在 js 目录下面。那么，只需要写成下面这样就行了：

<script src="js/require.js" data-main="js/main"></script>

ログイン後にコピー

　　data-main 属性的作用是，指定网页程序的主模块。在上例中，就是 js 目录下面的 main.js，这个文件会第一个被 require.js 加载。由于 require.js 默认的文件后缀名是 js，所以可以把 main.js 简写成 main。

　　三、主模块的写法

　　上一节的 main.js，我把它称为"主模块"，意思是整个网页的入口代码。它有点像C语言的 main ()函数，所有代码都从这儿开始运行。

　　下面就来看，怎么写 main.js。

　　如果我们的代码不依赖任何其他模块，那么可以直接写入 javascript 代码。

// main.js
alert ("加载成功！");

ログイン後にコピー

　　但这样的话，就没必要使用 require.js 了。真正常见的情况是，主模块依赖于其他模块，这时就要使用 AMD 规范定义的的 require ()函数。

// main.js
require (['moduleA'， 'moduleB'， 'moduleC'], function (moduleA, moduleB, moduleC){
// some code here
});

ログイン後にコピー

　　require () 函数接受两个参数。第一个参数是一个数组，表示所依赖的模块，上例就是['moduleA'， 'moduleB'， 'moduleC']，即主模块依赖这三个模块；第二个参数是一个回调函数，当前面指定的模块都加载成功后，它将被调用。加载的模块会以参数形式传入该函数，从而在回调函数内部就可以使用这些模块。

　　require () 异步加载 moduleA，moduleB 和 moduleC，浏览器不会失去响应；它指定的回调函数，只有前面的模块都加载成功后，才会运行，解决了依赖性的问题。

　　下面，我们看一个实际的例子。

　　假定主模块依赖 jquery、underscore 和 backbone 这三个模块，main.js 就可以这样写：

require (['jquery'， 'underscore'， 'backbone'], function ($， _, Backbone){
// some code here
});

ログイン後にコピー

　　require.js 会先加载 jQuery、underscore 和 backbone，然后再运行回调函数。主模块的代码就写在回调函数中。

　　四、模块的加载

　　上一节最后的示例中，主模块的依赖模块是['jquery'， 'underscore'， 'backbone']。默认情况下，require.js 假定这三个模块与 main.js 在同一个目录，文件名分别为 jquery.js，underscore.js 和 backbone.js，然后自动加载。

　　使用 require.config () 方法，我们可以对模块的加载行为进行自定义。require.config () 就写在主模块（main.js）的头部。参数就是一个对象，这个对象的 paths 属性指定各个模块的加载路径。

require.config ({
    paths: {
        "jquery": "jquery.min.js",
        "underscore": "underscore.min.js",
        "backbone": "backbone.min.js"
    }
});

ログイン後にコピー

　　上面的代码给出了三个模块的文件名，路径默认与 main.js 在同一个目录（js 子目录）。如果这些模块在其他目录，比如 js/lib 目录，则有两种写法。一种是逐一指定路径。

require.config ({
    paths: {
        "jquery": "lib/jquery.min.js",
        "underscore": "lib/underscore.min.js",
        "backbone": "lib/backbone.min.js"
    }
});

ログイン後にコピー

　　另一种则是直接改变基目录（baseUrl）。

require.config ({
    baseUrl: "js/lib",
    paths: {
        "jquery": "jquery.min.js",
        "underscore": "underscore.min.js",
        "backbone": "backbone.min.js"
    }
});

ログイン後にコピー

　　如果某个模块在另一台主机上，也可以直接指定它的网址，比如：

require.config ({
    paths: {
        "jquery": "https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min"
    }
});

ログイン後にコピー

　　require.js 要求，每个模块是一个单独的 js 文件。这样的话，如果加载多个模块，就会发出多次 HTTP 请求，会影响网页的加载速度。因此，require.js 提供了一个优化工具，当模块部署完毕以后，可以用这个工具将多个模块合并在一个文件中，减少 HTTP 请求数。

　　五、AMD 模块的写法

　　require.js 加载的模块，采用 AMD 规范。也就是说，模块必须按照 AMD 的规定来写。

　　具体来说，就是模块必须采用特定的 define () 函数来定义。如果一个模块不依赖其他模块，那么可以直接定义在 define () 函数之中。

　　假定现在有一个 math.js 文件，它定义了一个 math 模块。那么，math.js 就要这样写：

// math.js
define(function () {
    var add = function (x, y) {
        return x + y;
    };
    return {
        add: add
    };
});

ログイン後にコピー

　　加载方法如下：

// main.js
require(['math'], function (math) {
    alert(math.add(1, 1));
});

ログイン後にコピー

　　如果这个模块还依赖其他模块，那么 define ()函数的第一个参数，必须是一个数组，指明该模块的依赖性。

define(['myLib'], function (myLib) {
    function foo() {
        myLib.doSomething();
    }
    return {
        foo: foo
    };
});

ログイン後にコピー

　　当 require ()函数加载上面这个模块的时候，就会先加载 myLib.js 文件。

　　六、加载非规范的模块

　　理论上，require.js 加载的模块，必须是按照 AMD 规范、用 define () 函数定义的模块。但是实际上，虽然已经有一部分流行的函数库（比如 jQuery）符合 AMD 规范，更多的库并不符合。那么，require.js 是否能够加载非规范的模块呢？

　　回答是可以的。

　　这样的模块在用 require () 加载之前，要先用 require.config ()方法，定义它们的一些特征。

　　举例来说，underscore 和 backbone 这两个库，都没有采用 AMD 规范编写。如果要加载它们的话，必须先定义它们的特征。

require.config({
    shim: {
        'underscore': {
            exports: '_'
        },
        'backbone': {
            deps: ['underscore', 'jquery'],
            exports: 'Backbone'
        }
    }
});

ログイン後にコピー

　　require.config () 接受一个配置对象，这个对象除了有前面说过的 paths 属性之外，还有一个 shim 属性，专门用来配置不兼容的模块。具体来说，每个模块要定义（1）exports 值（输出的变量名），表明这个模块外部调用时的名称；（2）deps 数组，表明该模块的依赖性。

　　比如，jQuery 的插件可以这样定义：

shim: {
    'jquery.scroll': {
        deps: ['jquery'],
        exports: 'jQuery.fn.scroll'
    }
}

ログイン後にコピー

　　七、require.js 插件

　　require.js 还提供一系列插件，实现一些特定的功能。

　　domready 插件，可以让回调函数在页面 DOM 结构加载完成后再运行。

require(['domready!'], function (doc) {
    // called once the DOM is ready
});

ログイン後にコピー

　　text 和 image 插件，则是允许 require.js 加载文本和图片文件。

define([
    'text!review.txt',
    'image!cat.jpg'
    ],
    function (review, cat) {
        console.log(review);
        document.body.appendChild(cat);
    }
);

ログイン後にコピー

　　类似的插件还有 json 和 mdown，用于加载 json 文件和 markdown 文件。