SplitBody

ヘッダとボディを分離する理由

あなたは、ヘッダとボディを分離せず、何千〜何万行ものコードがフラットに書かれているライブラリを見たことはありませんか?
また { ... } なネームスペース(スコープ)が数千行にも及んでおり、どれが公開メソッドで、どれが内部関数なのか、さっぱり区別が付かないコードに遭遇したことはありませんか?

このようなカオスな状況に陥るのを予防するためにも、ヘッダとボディを分離しておくことをお勧めします。

ヘッダとボディを分離しておくと、コードの先頭部分(ヘッダ部分)を一瞥すれば 60〜80% の情報を得られる状態を維持することができます。

// スコープが巨大化する、ダメな実装例
// このようにしてしまうと、時間とともにファットに、見通しが悪くなっていく
(function(window, undefined) {
var Class = {
    method1: function() {
        ...
    },
    ...
    method99: function() {
        ...
    },
    method100: function() {
    }
};
window.Class = Class;
})(window);

ソースコードを見る人のほとんどは、API の一覧や、使い方の分からないメソッドの引数やとっかかりを把握をしたいだけだったりします。
そのような人に対して、ソースコードを最後まで査読させるのは時間の無駄です。

ヘッダとボディを分離する事で、このような無駄を無くす事ができます。