记录将函数作为参数的JS函数

Question

在JavaScript或PHP等动态语言中，通常只向函数传递一个参数。这个参数是封装所有选项的对象。用ScriptDoc（或类似的）记录这些选项的最佳方式是什么？

/** 
* @param {Object} o  Object containing function params. 
* @param {String} o.bar Example String param. 
* @param {Number} o.baz Example Number param. 
*/ 
function foo(o) { 
} 

更多信息可以在参数发现属性JSDoc的TagParam documentation的部分：

Answer 1

使用JSDoc可以做如下。