扩展goog.Disposable生成jsDoc错误

Question

我的一个类因为扩展了goog.Disposable而生成jsDoc错误。我使用@extends来指定这一点，但它仍然不起作用。使用closure linter编译文件时不会出现错误。代码可以在这里找到。“

Answer 1

您的JavaScript文件包含以下行：

goog.inherits(goog.Disposable, niuzly.base.errorHandler);

接受子构造函数，然后是父构造函数：

goog.inherits(niuzly.base.errorHandler, goog.Disposable);

对于JSDoc-Toolkit模板，您可以尝试使用gcodewiki。使用gcodewiki，我成功地为您的文件niuzly.base.errorHandler.js生成了JSDoc，但出现了以下警告：

>> WARNING: Trying to document errorHandler as a member of undocumented symbol niuzly.base.
>> WARNING: Can't augment contributer: goog.Disposable, not found.

将闭包库的base.js和disposable.js作为JSDoc-Toolkit的输入，消除了警告Can't augment contributer: goog.Disposable, not found.

要消除有关未记录的symbol niuzly.base的警告，您可以将以下内容添加到源文件中，或者直接忽略该警告。

/**
 * @type {Object} Namespace for Niuzly Inc.
 */
var niuzly = niuzly || {};

/**
 * @type {Object} Base namespace.
 */
niuzly.base = niuzly.base || {};

JSDoc 3

当只指定niuzly.base.errorHandler.js和disposable.js时，使用JSDoc 3而不是旧的JSDoc-Toolkit成功地生成了文档。此外，没有关于未记录的符号niuzly.base的警告。