2011-12-17 36 views
1

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函数作为参数或返回函数吗?

回答

3

你会使用类型的任何地方:

  • 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) { 
} 
+0

好的。我脑海中过度复杂。谢谢。 – 2011-12-18 00:39:46

+0

感谢您的这一点,我认为这也是必要的或用于评论功能本身。 – 2012-04-30 11:23:25