我將在哪裏使用谷歌關閉功能註釋？

Question

Closure Compiler可以使用有關JavaScript變量的數據類型信息來提供增強的優化和警告。

我在看their type expressions並查看幾個函數類型列表。例如：

{function(string, boolean)} 
A function that takes two parameters (a string and a boolean), and has an unknown return value. 

又如：

{function(new:goog.ui.Menu, string)} 
A function that takes one parameter (a string), and creates a new instance of goog.ui.Menu when called with the 'new' keyword. 

有人能告訴我在哪裏，我會使用這些註解，並給它會是什麼樣子在實踐中的例子嗎？它們主要用於@param和@return函數作爲參數或返回函數嗎？

Answer 1

你會使用類型的任何地方：

• VAR聲明
• 參數類型
• 返回類型
• 蒙上

一般來說，Closure庫是看的好地方例如：

http://code.google.com/p/closure-library/source/browse/trunk/closure/goog/base.js

但這裏有一些樣品：

正常功能：

/** 
* @param {string} a 
* @return {string} 
*/ 
function f(a) { 
    return a; 
} 

函數服用一般功能：

/** 
* @param {Function} a 
* @return {void} 
*/ 
function f(a) { 
} 

函數利用函數與單個參數必須是一個字符串並返回一個字符串：

/** 
* @param {function(string):string} a 
* @return {void} 
*/ 
function f(a) { 
}