如何在 JSDoc 中使用可选属性注释匿名对象

Question

我有一个 JavaScript 类，它接受一个 Object 类型的参数，并定义了一组属性，当我注释它时，闭包编译器很高兴：

@constructor
@param {{ subview:BaseView, el:(jQuery|Element), title:String }} options
var MyView = function(options){ }

我想将title键设为可选，并将title值传递给我的类的某些实例，并在此键不存在时实现回退行为，因此我使用以下注释对我的类进行了注释：

@constructor
@param {{ subview:BaseView, el:(jQuery|Element), title:String= }} options
var MyView = function(options){ }

现在 Closure Compiler 抱怨：

警告 - 错误的类型注释。 预计关闭 }

我已经检查了Annotating JavaScript for the Closure Compiler ，但我没有看到任何一行描述这种用例。

Answer 1

@param {{ subview:BaseView, el:(jQuery|Element), title:(string|undefined) }} options