擴展goog.Disposable產生jsDoc錯誤

Question

我的一個類生成jsDoc錯誤。我使用@extends來指定這個，但它仍然不起作用。文件使用閉包linter編譯沒有錯誤。 代碼可以在這裏找到」

Answer 1

你的JavaScript文件包含以下行：

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

goog.inherits需要孩子的構造其次是父類的構造：

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

對於一個JSDoc-Toolkit模板，你可以嘗試gcodewiki。使用gcodewiki，我成功生成JSD OC爲您的文件niuzly.base.errorHandler.js與以下警告：

>> 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-工具包消除了警告Can't augment contributer: goog.Disposable, not found.

爲了消除有關警告無證符號niuzly.base，你可以添加以下到您的源文件，或只是忽略警告。

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

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

JSDoc 3

使用JSDoc 3，而不是舊的JSDoc，工具包時指定唯一niuzly.base.errorHandler.js和disposable.js成功生成的文檔。此外，也沒有對無證符號niuzly.base警告。