Pot.globalize

{Array} Pot.globalize ([{Object} target[, {Boolean} advised = false]])

Pot.js と PotLite.js で利用可能。

Pot.js ライブラリまたは target をグローバル化します。

Pot.js (or PotLite.js) ライブラリの関数やプロパティ・オブジェクトをグローバルスコープに参照付けします。
グローバル化することにより、
例えば Pot.debug() が、たんに debug() と呼び出せるようになります。
このリファレンスのサンプルコードの多くは、便宜上 Pot.globalize が適応されたと仮定して表現しています。
適応しない場合の親オブジェクトは、関数の定義から参照できます (ここでは {Array} Pot.globalize の 'Pot')。
引数 target をオブジェクトで渡すと、Pot.js ライブラリの代わりに target が持つ関数/プロパティをグローバル化します。
その際に、引数 advised が 真 (true) として渡されると
同じ名前がグローバルスコープに定義されていた場合、上書きしない動作になります。
引数なしで Pot.js / PotLite.js ライブラリをグローバル化する場合は、常に上書きします。ご注意ください。

グローバルスコープへの上書きを避けた名前の配列が返ります。なかった場合、空の配列 [] が返ります。

// グローバル化して短い関数名を使用する例

try {
    debug( trim(' hoge ') ); // (Error: trim is undefined)
} catch (e) {
    Pot.debug( Pot.trim(' hoge ') ); // 'hoge'
}

Pot.globalize();

debug( trim(' hoge ') ); // 'hoge'
var obj = {
    foo : function() { return 'foo!'; },
    bar : function() { return 'bar!'; }
};

Pot.globalize(obj);

// e.g.,
debug(window.foo()); // 'foo!' (on Web Browser)
debug(bar());        // 'bar!'