記錄將函數作爲參數的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可以做如下。