为什么“会员不能有@私人JsDoc”？

Question

我正在使用Google Closure工具中的gjslint工具清理我的代码。据报告以下错误：

Line 15, E:0222: Member "this._dictionary" must not have @private JsDoc 

这是代码：

/** 
* Stacker class. 
* @constructor 
* @param {frankenstein.app.Dictionary} dictionary input dictionary for stacking. 
*/ 
frankenstein.app.Stacker = function(dictionary) { 
    /** @private */ this._dictionary = dictionary; 
}; 

有人可以解释为什么this._dictionary不得有@private JsDoc？谢谢！

Answer 1

Closure Linter旨在强制执行Google JavaScript Style Guide。该JSDoc标签@private被记录如下：

Used in conjunction with a trailing underscore on the method or property name to indicate that the member is private. Trailing underscores may eventually be deprecated as tools are updated to enforce @private .

作为闭幕短绒版本2.3.6，在误差“会员<名>不能有@private JsDoc”每当一个成员被标注@private没有将发射尾随下划线。

此代码不会发出任何错误或警告。

/** 
* Stacker class. 
* @constructor 
* @param {frankenstein.app.Dictionary} dictionary Input dictionary for 
*  stacking. 
*/ 
frankenstein.app.Stacker = function(dictionary) { 
    /** @private */ this.dictionary_ = dictionary; 
};